플랫폼 특징
기업 계정
팀이 하나의 기업 잔액을 공유할 때 API 키, 멤버 예산, 오류, 로그가 어떻게 동작하는지 설명합니다.
기업 계정을 사용하면 팀 전체가 하나의 잔액에서 사용할 수 있습니다. 소유자 계정의 잔액이 기업 잔액이 되고, 각 멤버는 자신의 키로 API를 호출하며, 모든 요금은 이 공유 잔액에서 차감됩니다. 엔드포인트, 요청 본문, 클라이언트 설정은 개인 계정과 같습니다. 이 페이지는 호출자가 기업에 속해 있을 때 달라지는 점만 설명합니다.
멤버가 요청을 보냄
acme-…기업 접두사로 시작하는 자신의 키를 사용합니다.
예산 확인
예상 비용이 멤버의 남은 예산 안에 들어가야 합니다.
기업에 청구
소유자 계정의 가격, 그룹, 구독으로 과금됩니다.
멤버 이름으로 기록
소유자와 관리자는 멤버, 모델, 키, 날짜별로 세부 내역을 볼 수 있습니다.
| 역할 | 계정 | 할 수 있는 일 |
|---|---|---|
| 소유자 | 신청한 계정 | 이 계정의 잔액이 기업 잔액입니다. 모든 사람을 관리하고, 충전하며, 기업 전체의 사용량을 확인합니다. 비활성화할 수 없습니다. |
| 관리자 | 초대로 생성 | 예산 범위 안에서 API를 호출하고, 멤버를 초대·관리하며, 충전하고, 기업 전체의 사용량을 확인합니다. |
| 멤버 | 초대로 생성 | 예산 범위 안에서 API, 이미지·동영상 워크벤치, Castaly를 사용합니다. 충전할 수 없습니다. |
관리자와 멤버는 이메일 초대로 생성되는 새 계정입니다. 초대받은 이메일 주소는 아직 가입되지 않은 주소여야 하므로, 기존 개인 계정은 기업에 합류할 수 없습니다. 이 계정들은 플랫폼 보상 프로그램에 참여하지 않습니다.
소유자와 관리자는 언제든지 계정을 비활성화할 수 있으며, 그 즉시 해당 계정의 세션과 키가 작동을 멈춥니다. 계정은 비활성화만 되고 삭제되지 않으므로 사용 기록이 남습니다.
API 키
섹션 제목: “API 키”기업 키는 기업의 키 접두사로 시작합니다. 예를 들어 acme- 뒤에 영문자와 숫자 48자가 이어집니다. 접두사는 신청할 때 정하며, 승인 시 확정되고 이후에는 변경할 수 없습니다. 접두사는 소문자 영문자와 숫자로 된 2~16자이며 영문자로 시작합니다.
같은 키는 접두사 자리에 sk-를 써도 동작합니다. sk-로 시작하는 키만 받는 클라이언트에는 이 형식을 사용하세요. 두 형식은 같은 키이며 권한과 과금도 같습니다.
Authorization: Bearer acme-<48 characters>Authorization: Bearer sk-<48 characters>키가 속한 기업의 것이 아닌 접두사를 붙인 키는 유효하지 않은 키로 처리되어 401로 거부됩니다.
신청이 승인되기 전에 소유자가 만든 키도 기업 접두사로 표시됩니다. 기존 sk- 형식도 계속 동작하므로 기존 연동은 변경할 필요가 없습니다.
관리자와 멤버는 콘솔에서 자신의 키만 만들고 볼 수 있습니다. 소유자와 관리자는 기업 콘솔에서 기업의 모든 키를 멤버별로 관리할 수 있습니다.
멤버 예산
섹션 제목: “멤버 예산”모든 관리자와 멤버에게는 예산이 있습니다. 돈이 이들에게 옮겨지지는 않으며, 예산은 기업 잔액에서 쓸 수 있는 최대 금액입니다.
| 모드 | 동작 |
|---|---|
| 무제한 | 기업 잔액으로만 제한됩니다. |
| 1회성 | 저절로 초기화되지 않는 고정 할당량입니다. |
| 매월 | 매월 1일 00:00 UTC에 0부터 다시 시작합니다. |
한도만 변경하면 이미 사용한 금액이 유지됩니다. 다른 모드로 바꾸면 0부터 다시 계산합니다.
요청을 실행하기 전에 게이트웨이는 예상 비용을 멤버의 남은 예산에서 예약하고, 남은 예산이 부족하면 요청을 거부합니다. 이후 요청은 실제 비용으로 정산됩니다. 정산 단계에서는 거부하지 않으므로 마지막 요청으로 멤버가 한도를 약간 넘을 수 있으며, 그다음 요청이 거부됩니다. 요청이 실패하거나 환불되면 그 금액도 멤버의 예산으로 돌아갑니다.
멤버는 예산의 80%를 사용했을 때와 모두 사용했을 때 이메일을 받습니다.
과금, 그룹, 속도 제한
섹션 제목: “과금, 그룹, 속도 제한”게이트웨이 입장에서 멤버의 요청은 소유자 계정의 요청입니다. 예산을 제외한 모든 것은 소유자를 따릅니다.
- 요금은 소유자가 직접 호출할 때와 같은 방식으로 기업 잔액에서 차감되며, 소유자의 구독도 포함됩니다.
- 가격, 그룹, 키로 호출할 수 있는 모델은 소유자 계정의 것을 따릅니다.
- 속도 제한은 기업 전체 기준으로 계산됩니다. 소유자와 모든 멤버가 하나의 한도를 공유하므로,
429는 다른 사람의 트래픽 때문에 발생할 수 있습니다.
기업 잔액이 소진되면 기업 내 모든 사람의 요청이 403 및 insufficient_user_quota로 실패하며, 이는 개인 계정과 같습니다. 소유자와 관리자는 기업 콘솔에서 충전할 수 있지만 멤버는 할 수 없습니다. 잔액 알림을 설정하면 잔액이 그 아래로 떨어질 때 소유자와 관리자가 이메일을 받습니다.
| 상황 | 상태 | 확인 방법 |
|---|---|---|
| 키에 다른 기업의 접두사가 붙어 있음 | 401 |
유효하지 않은 키로 거부 |
| 멤버의 예산이 소진됨 | 403 |
code가 enterprise_member_budget_exhausted |
| 멤버가 비활성화되었거나 기업이 정지됨 | 403 |
message에 계정이 비활성화되었다고 표시됨 |
| 기업 잔액이 소진됨 | 403 |
code가 insufficient_user_quota |
| 기업 전체가 속도 제한에 도달함 | 429 |
개인 계정과 동일 |
401 및 403 경우는 재시도해도 해결되지 않습니다. 예산 오류는 관리자가 한도를 올리거나, 월간 예산이라면 다음 달이 시작되면 해소됩니다. 잔액 오류는 충전 후 해소됩니다.
비동기 작업
섹션 제목: “비동기 작업”멤버의 키로 제출한 작업은 해당 멤버의 키로만 조회할 수 있습니다. 다른 멤버의 키로 조회하면 존재하지 않는 작업과 같은 결과가 반환됩니다. 소유자의 키로는 기업 내 누가 제출한 작업이든 조회할 수 있습니다.
사용량과 로그
섹션 제목: “사용량과 로그”- 모든 요청 로그에 어느 멤버가 요청을 보냈는지 기록됩니다.
- 자신의 콘솔에서 관리자와 멤버는 자신의 요청만 볼 수 있습니다.
- 소유자의 로그 페이지에는 기업 전체의 요청이 표시되며, ‘멤버’ 열이 추가됩니다.
- 소유자와 관리자는 기업 콘솔에서 지출을 멤버, 모델, 키, 날짜별로 나누어 보고, 어떤 멤버의 개별 요청이든 열어 볼 수 있습니다.
- 조회할 수 있는 기간은 소유자 계정의 로그 보존 기간을 따릅니다. 데이터 보존을 참고하세요. 소유자가 기간을 줄이면 기업 보고서도 함께 줄어듭니다.
기업 계정 만들기
섹션 제목: “기업 계정 만들기”Modelflare 콘솔에서 기업 이름, 원하는 키 접두사, 연락처 이메일을 입력해 신청하세요. 신청이 승인되면 내 계정이 소유자가 되고 그 잔액이 기업 잔액이 되며, 기업 콘솔에서 팀원을 초대합니다. 전체 플랜은 엔터프라이즈 페이지에서 확인할 수 있습니다.