API
에러 코드
요약
API 사용 중 발생할 수 있는 에러 코드와 해결 방법을 안내합니다. 모든 에러 응답은 일관된 형식으로 제공됩니다.
HTTP 에러 코드
API 요청 중 발생할 수 있는 HTTP 에러 코드 목록입니다.
| 상태 코드 | 에러 타입 | 응답 메시지 | 설명 |
|---|---|---|---|
| 400 | invalid_request_error | Invalid JSON in request body | 잘못된 형식의 JSON |
| 400 | invalid_request_error | Missing required parameter: 'model' | 필수 파라미터 누락 |
| 401 | authentication_error | Authorization header is not supplied | 인증 헤더 누락 또는 형식 오류 |
| 401 | authentication_error | Bearer token is not supplied | 유효하지 않은 Bearer 토큰 |
| 401 | authentication_error | Invalid API key | 유효하지 않은 API 키 |
| 402 | insufficient_quota | Quota exceeded | 할당량 초과 |
| 403 | permission_denied | No access to model | 모델 접근 권한 없음 |
| 404 | invalid_request_error | Model 'gpt-5' not found. Available models: [...] | 모델을 찾을 수 없음 |
| 429 | rate_limit_exceeded | Rate Limit Exceeded | 요청 한도 초과 (분당 60회 요청) |
| 503 | service_unavailable | Service temporarily unavailable | 서비스 일시 중단 |
| varies | api_error | Provider API error | 오픈AI/구글/앤트로픽 서비스 제공자 오류 |
에러 응답 형식
모든 에러는 다음과 같은 일관된 JSON 형식으로 반환됩니다:
{
"detail": {
"code": 400,
"message": "invalid_request_error - Invalid JSON in request body"
}
}
메시지는
"{error_type} - {message}" 형식으로 제공됩니다.API 키는 API 소개 페이지에서 발급받을 수 있습니다. 에러가 지속되는 경우 고객 지원팀에 문의하세요.
마지막 수정 날짜: Nov 05, 2025