Errors

Error response shape

Troubleshooting tips

• 401 invalid_api_key — check the Authorization header format and that the key has not been revoked.
• 400 param_error / invalid_messages — validate your request body against the field lists on each endpoint page.
• 400 model_not_routed / model_not_allowed — the model alias does not exist, is not enabled, or is outside your key’s allowlist; check GET /api/v1/models.
• 429 rate_limit / concurrency_limit_exceeded — you have hit your concurrency or rate limit; retry with backoff.
• 429 quota_exceeded — your account or key has insufficient Credits or has hit a spending limit.
• 5xx / upstream errors — transient upstream failure; safe to retry with backoff for idempotent requests.
• task_failed / task_expired / task_not_found — see the Async tasks page for the task status machine.