Check the HTTP status code first, then read the error message.
| Status | Common cause | Action |
|---|---|---|
| 400 | Unsupported request or parameters | Check model, messages and parameter types |
| 401 | Missing or invalid key | Check Bearer authentication and spacing |
| 403 | Group or permission restriction | Check key status and group access |
| 404 | Unknown model or endpoint | Check the base URL and model ID |
| 429 | Rate, quota or concurrency limit | Check quota, lower concurrency and follow retry guidance |
| 502 / 503 | Unavailable or unconfigured upstream | Check service status and contact your administrator |
Provide diagnostic information
Record the request time, model ID, HTTP status and error message. Do not include API keys, passwords or complete sensitive prompts in a support brief.
Check service status