모든 에러는 OpenAI 호환 envelope 으로 반환됩니다.
{
"error": {
"message": "Incorrect API key provided. ...",
"type": "authentication_error",
"param": null,
"code": "invalid_api_key"
}
}| 상태 | type / code | 의미 |
|---|---|---|
| 400 | invalid_request_error | 잘못된 파라미터 / 컨텍스트 초과 (재시도 금지) |
| 401 | authentication_error / invalid_api_key | 키 누락·오류·만료 |
| 402 | insufficient_quota_error / insufficient_quota | 크레딧 부족 또는 지출 한도 도달 |
| 403 | permission_error / model_not_allowed · insufficient_scope | 키의 허용 모델·스코프 제한 |
| 404 | invalid_request_error / model_not_found · job_not_found | 존재하지 않는 모델 또는 작업 |
| 413 | invalid_request_error | 요청 본문 초과(이미지 편집 5MB) |
| 429 | rate_limit_error / rate_limit_exceeded | 레이트리밋 — Retry-After 헤더 후 재시도 |
| 502 | api_error / backend_unavailable | 업스트림 프로바이더 장애 (재시도 가능) |
레이트리밋
기본 레이트리밋은 키당 100 req/min 이며 키 생성·수정 시 조정할 수 있습니다.
응답의 X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset 헤더로 잔여량을 확인하세요.
인증 엔드포인트(로그인·회원가입 등)에는 더 낮은 별도 한도가 적용됩니다.