Errors

The developer API returns OpenAI-style errors where possible.

{
  "error": {
    "message": "Missing API key. Provide it as a Bearer token.",
    "type": "authentication_error",
    "code": "missing_api_key"
  }
}

Website/account APIs return compact JSON errors:

{ "ok": false, "code": "unauthorized" }

Developer API error classes

• missing, invalid, or revoked API key
• account suspended
• insufficient endpoint scope
• endpoint not enabled
• model not allowed
• input/output token cap exceeded
• context window exceeded
• quota or rate limited
• requested model route temporarily unavailable
• service unable to complete the request

Common developer API error codes are listed in API Reference.

Website API error classes

• unauthenticated session
• private beta access denied
• CSRF or same-origin validation failure
• account database not configured
• invalid auth code or expired magic link
• payment order validation failure
• webhook authentication or payload validation failure