오류 코드

Updated 2026. 9. 19.

요청이 실패하면 통합된 오류 구조가 반환되며, code 필드는 기계가 읽을 수 있는 코드입니다.

오류 코드 표

HTTP	코드	청구	설명
400	`invalid_request`	아니요	잘못된 요청 매개변수
401	`invalid_api_key`	아니요	API 키가 없거나 유효하지 않음
402	`insufficient_balance`	아니요	잔액 부족 — 충전 필요
403	`model_not_allowed`	아니요	이 키로 해당 모델에 대한 접근 권한 없음
429	`rate_limit_exceeded`	아니요	요청 제한 — 나중에 다시 시도
500	`billing_settlement_error`	비동기 조정	청구 정산 실패
502	`upstream_error`	보통 없음	상위 서비스 오류
503	`model_provider_unavailable`	없음	모델 서비스가 일시적으로 이용 불가
504	`upstream_timeout`	일반적으로 없음	상위 서비스 시간 초과

문제 해결

401: Authorization: Bearer 값이 전체 sk-live-* 시크릿인지, 키가 취소되지 않았는지 확인하십시오.
402: 콘솔에서 잔액을 충전하십시오.
429: 동시 접속 수를 줄이거나, retry-after이 발생할 때까지 기다린 후 다시 시도하십시오.
5xx: 잠시 후 다시 시도하십시오. 문제가 지속되면 request_id을 첨부하여 지원팀에 문의하십시오.

오류 예시

{
  "error": {
    "message": "insufficient balance",
    "type": "request_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_8f2a…c91d"
  }
}