Error Codes

Error Response Format

When an error occurs, the response is returned in the following JSON format.

{
  "error": {
    "code": "E4001",
    "message": "API key is required. Provide X-API-Key header.",
    "details": "optional additional info"
  }
}

AICC returns the same common codes in a flat response for compatibility with existing clients.

{
  "error": "message or a user message in history is required",
  "code": "E4201"
}

Code	HTTP	Description
`E4001`	`401`	API key is required. Provide X-API-Key header.
`E4002`	`401`	Invalid API key

Code	HTTP	Description
`E4101`	`403`	Permission denied

Code	HTTP	Description
`E4201`	`400`	Invalid request
`E4202`	`400`	Text exceeds maximum length
`E4203`	`400`	Invalid audio
`E4204`	`413`	Request body exceeds the allowed size

Code	HTTP	Description
`E4301`	`404`	Resource not found
`E4302`	`409`	Resource not ready

Code	HTTP	Description
`E4401`	`429`	Usage limit exceeded
`E4402`	`429`	Guest daily limit exceeded
`E4403`	`429`	Per-minute request or character limit exceeded

Code	HTTP	Description
`E4501`	`405`	Method not allowed

Code	HTTP	Description
`E4601`	`402`	Insufficient credits to process the request

Code	HTTP	Description
`E5001`	`500`	Internal server error
`E5002`	`503`	Service temporarily unavailable
`E5003`	`500`	Processing timeout