Prosody

에러 코드

오류 응답 형식

오류 발생 시 다음과 같은 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설명
E4001401API 키가 필요합니다. X-API-Key 헤더를 제공하세요.
E4002401유효하지 않은 API 키

권한 (Authorization)

코드HTTP설명
E4101403권한이 없습니다

입력 검증 (Validation)

코드HTTP설명
E4201400잘못된 요청입니다
E4202400텍스트가 최대 길이를 초과했습니다
E4203400유효하지 않은 오디오
E4204413요청 body가 허용 크기를 초과했습니다

리소스 (Resource)

코드HTTP설명
E4301404리소스를 찾을 수 없습니다
E4302409리소스가 준비되지 않았습니다

사용량 제한 (Rate Limit)

코드HTTP설명
E4401429사용량 한도를 초과했습니다
E4402429게스트 일일 한도를 초과했습니다
E4403429분당 요청 또는 글자 수 한도를 초과했습니다

메서드 (Method)

코드HTTP설명
E4501405허용되지 않은 메서드입니다

결제 및 크레딧 (Billing)

코드HTTP설명
E4601402요청을 처리할 크레딧이 부족합니다

서버 (Server)

코드HTTP설명
E5001500내부 서버 오류
E5002503일시적으로 서비스를 사용할 수 없습니다
E5003500처리 시간이 초과되었습니다