오류 응답 형식
모든 오류는 일관된 JSON 형식을 반환합니다:HTTP 상태 코드
| 코드 | 설명 |
|---|---|
| 400 | Bad Request - 잘못된 파라미터 |
| 401 | Unauthorized - 유효하지 않거나 누락된 API 키 |
| 402 | Payment Required - 잔액 부족 |
| 403 | Forbidden - 액세스 거부 또는 허용되지 않은 모델 |
| 404 | Not Found - 모델 또는 리소스를 찾을 수 없음 |
| 413 | Payload Too Large - 입력 또는 파일 크기 초과 |
| 429 | Too Many Requests - 속도 제한 초과 |
| 500 | Internal Server Error |
| 502 | Bad Gateway - 업스트림 제공자 오류 |
| 503 | Service Unavailable - 모든 채널 실패 |
| 504 | Gateway Timeout - 요청 시간 초과 |
오류 유형
인증 오류 (401)
| 유형 | 코드 | 설명 |
|---|---|---|
invalid_api_key | invalid_api_key | API 키가 누락되었거나 유효하지 않음 |
expired_api_key | expired_api_key | API 키가 취소됨 |
결제 오류 (402)
| 유형 | 코드 | 설명 |
|---|---|---|
insufficient_quota | insufficient_quota | 계정 잔액이 너무 낮음 |
quota_exceeded | quota_exceeded | API 키 사용량 한도 도달 |
액세스 오류 (403)
| 유형 | 코드 | 설명 |
|---|---|---|
access_denied | access_denied | 리소스 액세스 거부됨 |
access_denied | model_not_allowed | 이 API 키에 허용되지 않은 모델 |
유효성 검사 오류 (400)
| 유형 | 설명 |
|---|---|
invalid_request_error | 요청 파라미터가 유효하지 않음 |
context_length_exceeded | 모델에 비해 입력이 너무 김 |
model_not_found | 요청한 모델이 존재하지 않음 |
속도 제한 오류 (429)
속도 제한을 초과한 경우:페이로드 너무 큼 (413)
입력 또는 파일 크기가 제한을 초과한 경우:- 이미지 파일이 너무 큼 (최대 20MB)
- 오디오 파일이 너무 큼 (최대 25MB)
- 입력 텍스트가 모델 컨텍스트 길이를 초과함
업스트림 오류 (502, 503)
| 유형 | 설명 |
|---|---|
upstream_error | 제공자가 오류를 반환함 |
all_channels_failed | 사용 가능한 제공자 없음 |
timeout_error | 요청 시간 초과 |
Python에서 오류 처리하기
JavaScript에서 오류 처리하기
권장 사항
지수 백오프 구현
지수 백오프 구현
속도 제한이 발생하면 재시도 간격을 점진적으로 늘리십시오:
타임아웃 설정
타임아웃 설정
요청이 중단되는 것을 방지하기 위해 항상 적절한 타임아웃을 설정하십시오:
디버깅을 위한 오류 로깅
디버깅을 위한 오류 로깅
지원을 받기 위해 요청 ID를 포함한 전체 오류 응답을 로깅하십시오:
모델별 오류 처리
모델별 오류 처리
일부 모델에는 특정 요구 사항(예: 최대 토큰, 이미지 형식)이 있습니다.
요청을 보내기 전에 입력을 유효성 검사하십시오.