Error Handling

The API uses standard HTTP status codes. Errors are returned as JSON with code and description.

Error Response Format

{
  "error": {
    "code": "insufficient_balance",
    "message": "Not enough tokens for this request",
    "required": 100,
    "available": 50
  }
}

Error Codes

Status	Code	Description
`400`	`bad_request`	Invalid request parameters
`401`	`unauthorized`	Missing or invalid API key
`402`	`insufficient_balance`	Insufficient credit balance
`429`	`rate_limited`	Rate limit exceeded
`500`	`internal_error`	Internal server error