Errors

Errors use one shape.

{
  "error": {
    "code": "invalid_request",
    "message": "duration_seconds must be between 5 and 120.",
    "request_id": "req_abc123"
  }
}

Common codes

Code	Meaning
`invalid_request`	The request body, parameters, or uploaded file are invalid.
`authentication_failed`	The API key is missing, invalid, or expired.
`permission_denied`	The key does not have access to the requested resource.
`not_found`	The requested resource does not exist.
`rate_limited`	The request exceeded the current rate limit.
`provider_unavailable`	A generation provider is temporarily unavailable.
`internal_error`	An unexpected error occurred.

Retrying requests

Retry transient 429, 502, 503, and 504 responses with exponential backoff. For billable creation endpoints, always include an Idempotency-Key header before retrying.