Error handling
| Status | Meaning | Action |
|---|---|---|
| 400 | Invalid request or unsupported field/model combination | Check the response body and request schema |
| 401 | Missing, invalid, or disabled key | Check the host and authorization header |
| 403 | Key lacks model or group permission | Use an allowed model or update the key |
| 429 | Quota or rate limit | Inspect balance and retry-after; do not retry exhausted quota |
| 500–504 / 529 | Gateway or upstream failure | Retry idempotent requests with capped exponential backoff |
When contacting support, include the timestamp, endpoint, HTTP status, model, and request ID. Never include the complete API key or private prompt content.