DOCS
Errors
Errors follow the OpenAI shape: {"error": {"message", "type", "code"}}. No stack traces or provider credentials are ever exposed.
| HTTP | CODE | MEANING |
|---|---|---|
| 400 | invalid_request | Bad body / unknown field |
| 401 | invalid_api_key | Missing, unknown or revoked key |
| 404 | model_not_found | Unknown or disabled model |
| 429 | rate_limit_exceeded / insufficient_quota | Slow down or upgrade plan (includes Retry-After) |
| 503 | provider_not_connected | Provider credentials not configured server-side |
| 504 | provider_timeout | Upstream timed out (retryable) |
| 502/503 | provider_error | Upstream failed (retry + fallback attempted for transient errors) |
All gateway errors include an OpenAI-shaped error object plus request_id and an X-Request-ID header. Provider failures are normalized — no API keys, headers, stacks, or paths leak.