Troubleshooting
401 Unauthorized
Section titled “401 Unauthorized”Confirm the Authorization: Bearer ... format and check whether the key expired, was rotated, or contains extra whitespace.
Model not found
Section titled “Model not found”Request GET /v1/models again and confirm the model is visible to the current API key. Do not rely only on a cached web page or old configuration.
Request timeout
Section titled “Request timeout”- Configure separate connection and overall response timeouts.
- Prefer streaming for long output.
- Use bounded retries only when a request can be replayed safely.
- Apply exponential backoff with a maximum retry count.
Streaming output arrives all at once
Section titled “Streaming output arrives all at once”Check whether the client or an intermediate reverse proxy buffers the response. Use curl -N for a command-line comparison.
Still blocked
Section titled “Still blocked”Record the request time, HTTP status, model, and a redacted request ID. Never submit API keys, complete user data, or untreated request logs.