개요
API 결제 또는 할당량 오류는 승인된 사용량 한도나 설정된 지출 한도에 도달했거나 선불 크레딧을 모두 사용했다는 의미일 수 있습니다. 설정을 변경하기 전에 오류를 확인하세요.
오류 확인
API 응답에서 error.code를 확인하세요. 결제 관련 오류에도 더 포괄적인 error.type 값인 insufficient_quota가 사용될 수 있습니다.
| 오류 코드 | 의미 | 다음 단계 |
| organization_usage_limit_exceeded | 조직이 OpenAI에서 할당한 사용량 한도에 도달했습니다. | 승인된 한도와 한도를 늘릴 수 있는 옵션을 확인하세요. |
| organization_spend_limit_exceeded | 조직이 설정된 지출 상한에 도달했습니다. | 조직의 지출 관리 설정을 확인하세요. |
| project_spend_limit_exceeded | 프로젝트가 설정된 지출 상한에 도달했습니다. | 해당 프로젝트의 지출 관리 설정을 확인하세요. |
| credit_balance_exhausted | 조직에 남아 있는 선불 크레딧이 없습니다. | API 잔액에 크레딧을 추가하세요. |
관련 크레딧이나 한도 문제를 해결하지 않으면 이러한 오류가 발생한 요청을 다시 시도해도 액세스가 복구되지 않습니다. 자세한 내용은 API 오류 코드 가이드를 참고하세요.
승인된 사용량 한도 확인
조직의 한도 페이지로 이동하여 현재 승인된 월간 사용량 한도와 사용량 등급을 확인하세요.
API 지출이 늘어나면 OpenAI가 조직의 사용량 등급을 자동으로 높입니다. 일반적으로 이렇게 하면 대부분 모델의 요청 한도가 늘어납니다. 모든 계정의 월간 허용량이 같다고 가정하지 말고 조직에 표시된 한도를 기준으로 사용하세요.
등급에 관한 자세한 내용은 API 요청 한도 가이드를 참고하세요.
설정된 지출 관리 항목 확인
지출 알림은 API 트래픽을 중단하지 않고 알림만 보냅니다. 추적된 지출이 설정 금액에 도달하면 지출 상한으로 인해 관련 요청이 중단될 수 있습니다.
조직 한도와 프로젝트 한도가 모두 적용될 수 있습니다. 조직 한도는 소속 프로젝트에 적용되고, 프로젝트 한도는 해당 프로젝트에 청구되는 트래픽에 적용됩니다. 이러한 관리 설정은 OpenAI에서 승인한 사용량 한도와 별개입니다.
지출 상한으로 인해 오류가 발생했으며 지출을 계속해야 하는 경우, 관련 설정을 관리할 권한이 있는 사용자가 한도를 높이거나 삭제할 수 있습니다. 그렇지 않으면 다음 월간 주기에 한도가 재설정됩니다. 변경 사항과 한도 적용은 즉시 이루어지지 않으므로 기록된 지출이 설정 금액을 약간 초과할 수 있습니다.
설정 및 지침은 API 지출 한도 가이드를 참고하세요.
선불 잔액 확인
선불 크레딧을 모두 사용했다면 API 결제 포털로 이동하여 표시되는 항목에 따라 크레딧 구매 또는 크레딧 잔액 추가를 선택해 크레딧을 더 구매하세요. 업데이트된 잔액이 표시되기까지 몇 분 정도 걸릴 수 있습니다.
설정 및 충전 방법은 선불 결제 설정하기를 참고하세요.
요청 한도 오류인지 확인
요청 및 토큰 요청 한도는 API를 사용할 수 있는 속도를 제어합니다. 이는 월간 사용량 한도, 지출 관리 설정, 선불 잔액과는 다릅니다.
요청 또는 토큰 요청 한도 오류에 관해서는 API 요청 한도 오류 문제 해결을 참고하세요.
문제가 계속되는 경우
문의를 진행하기 전에
오류 메시지와 코드, 오류가 발생한 시간 및 시간대, 관련 요청 ID를 준비하세요. 공유하는 스크린샷이나 코드에서 민감한 정보를 삭제하세요.
OpenAI 지원팀에 문의
필요한 사용량이 조직에 제공되는 한도를 초과하거나, 특수한 사용 사례가 있거나, 원인을 해결한 후에도 오류가 계속되면 도움말 센터의 채팅 위젯을 사용하여 OpenAI 지원팀에 문의하세요.
문의 방법과 제공해야 할 정보는 지원팀에 문의하기를 참고하세요.