지출 알림으로 월간 API 비용을 추적하세요. 집계된 지출액이 설정한 금액에 도달했을 때 트래픽을 중단하려면 조직이나 개별 프로젝트에 지출 한도를 강제 적용하세요.
지출 한도를 강제 적용하면 프로덕션 트래픽이 중단될 수 있습니다. 집계된 지출액이 해당 한도에 도달하면 영향을 받는 API 요청은 429 오류를 반환하며, 오류 코드는 organization_spend_limit_exceeded 또는 project_spend_limit_exceeded입니다. 한도가 즉시 적용되지는 않으므로 기록된 지출액이 설정한 금액을 약간 초과할 수 있습니다.
지출 관리 방식 선택
지출 알림과 지출 한도 강제 적용은 다음과 같이 작동합니다.
| 관리 방식 | 설정한 금액에 도달했을 때 | 용도 |
|---|---|---|
| 지출 알림 | 알림을 보내고 API 트래픽은 계속 처리함 | 트래픽 중단 없이 지출 추적 |
| 지출 한도 강제 적용 | 영향을 받는 API 요청이 429 오류를 반환함 |
조직 또는 프로젝트의 월간 지출 한도 강제 적용 |
지출 알림만으로는 지출이 제한되지 않습니다. 지출 한도를 강제 적용해도 알림은 계속 활성화되므로, 한도에 도달해 트래픽이 중단되기 전에 알림을 받을 수 있습니다.
OpenAI는 조직의 사용 등급에 따라 월간 사용 한도도 정합니다. OpenAI가 승인한 이 사용 한도는 직접 설정하는 지출 한도와 별개입니다.
지출 한도 설정
해당 조직이나 프로젝트의 설정을 관리할 권한이 필요합니다. 자세한 내용은 API 플랫폼 권한을 참고하세요.
지출 한도 강제 적용 방식
하나의 요청에 조직 한도와 프로젝트 한도가 모두 강제 적용될 수 있습니다.
- 조직 한도는 조직 내 모든 프로젝트의 API 트래픽에 적용됩니다.
- 프로젝트 한도는 해당 프로젝트에 비용이 청구되는 API 트래픽에만 적용됩니다.
- 조직 한도에 도달하면 API 요청은
429오류를 반환하며, 오류 코드는organization_spend_limit_exceeded입니다. - 프로젝트 한도에 도달하면 API 요청은
429오류를 반환하며, 오류 코드는project_spend_limit_exceeded입니다. - 이미 도달한 한도를 높이거나 해제하면 변경 사항이 반영된 후 트래픽을 재개할 수 있습니다. 한도를 그대로 두면 다음 월간 주기가 시작될 때 초기화됩니다.
한도는 즉시 적용되지 않습니다. 한도 도달 상태가 시스템 전체에 반영되는 동안 API 플랫폼에서 소량의 추가 트래픽을 처리할 수 있어, 기록된 지출액이 설정한 금액을 약간 초과할 수 있습니다.
지출 알림
지출 한도를 강제 적용하는 경우 한도에 도달하기 전에 알림을 받도록 설정하세요. 사용량을 조정하거나 한도를 높이거나 예상치 못한 트래픽의 원인을 조사할 시간이 충분하도록 기준 금액을 정해 알림을 추가하세요.
API 트래픽 복구
결제 관련 한도나 크레딧 잔액 때문에 요청이 실패하면 다음 절차를 따르세요.
error.code를 확인해 조직 지출 한도, 프로젝트 지출 한도 또는 OpenAI가 정한 사용 한도에 도달했는지, 아니면 조직의 선불 크레딧이 소진되었는지 파악하세요.- 오류 코드가
organization_spend_limit_exceeded또는project_spend_limit_exceeded이면 현재 사용량을 지출 한도와 비교하세요. 다음 월간 주기가 시작되기 전에 트래픽을 재개하려면 이미 도달한 한도를 높이거나 해제하세요. - 오류 코드가
organization_usage_limit_exceeded이면 승인된 사용 한도의 상향을 요청하세요. - 오류 코드가
credit_balance_exhausted이면 크레딧을 추가하세요. - 오류 메시지에 일정 시간 동안의 요청 수나 토큰 수가 한도에 도달했다고 표시되면 요청 한도 가이드를 따르세요.