에러 코드
오류 응답 형식
오류 발생 시 다음과 같은 JSON 형식으로 응답합니다.
음성 API
{
"error": {
"code": "E4001",
"message": "API key is required. Provide X-API-Key header.",
"details": "optional additional info"
}
}AICC API
AICC는 기존 클라이언트 호환을 위해 같은 공통 코드를 평면 형식으로 반환합니다.
{
"error": "message or a user message in history is required",
"code": "E4201"
}에러 코드 목록
인증 (Authentication)
| 코드 | HTTP | 설명 |
|---|---|---|
E4001 | 401 | API 키가 필요합니다. X-API-Key 헤더를 제공하세요. |
E4002 | 401 | 유효하지 않은 API 키 |
권한 (Authorization)
| 코드 | HTTP | 설명 |
|---|---|---|
E4101 | 403 | 권한이 없습니다 |
입력 검증 (Validation)
| 코드 | HTTP | 설명 |
|---|---|---|
E4201 | 400 | 잘못된 요청입니다 |
E4202 | 400 | 텍스트가 최대 길이를 초과했습니다 |
E4203 | 400 | 유효하지 않은 오디오 |
E4204 | 413 | 요청 body가 허용 크기를 초과했습니다 |
리소스 (Resource)
| 코드 | HTTP | 설명 |
|---|---|---|
E4301 | 404 | 리소스를 찾을 수 없습니다 |
E4302 | 409 | 리소스가 준비되지 않았습니다 |
사용량 제한 (Rate Limit)
| 코드 | HTTP | 설명 |
|---|---|---|
E4401 | 429 | 사용량 한도를 초과했습니다 |
E4402 | 429 | 게스트 일일 한도를 초과했습니다 |
E4403 | 429 | 분당 요청 또는 글자 수 한도를 초과했습니다 |
메서드 (Method)
| 코드 | HTTP | 설명 |
|---|---|---|
E4501 | 405 | 허용되지 않은 메서드입니다 |
결제 및 크레딧 (Billing)
| 코드 | HTTP | 설명 |
|---|---|---|
E4601 | 402 | 요청을 처리할 크레딧이 부족합니다 |
서버 (Server)
| 코드 | HTTP | 설명 |
|---|---|---|
E5001 | 500 | 내부 서버 오류 |
E5002 | 503 | 일시적으로 서비스를 사용할 수 없습니다 |
E5003 | 500 | 처리 시간이 초과되었습니다 |