Error codes
Every Model API error code, what it means and what to do.
- How do I detect an error that happens in the middle of a stream?A stream that fails midway sends data: {"error": ...} and then data: [DONE]. Check each chunk for an error object.Troubleshooting
- I'm on a team and get team_scope_denied or team_spend_limit_reached. What now?Team members use the owner's credits within limits the owner sets. What 403 team_scope_denied and the 429 team limits mean.Troubleshooting
- What does 400 invalid_effort mean?invalid_effort (400) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 400 invalid_json mean?invalid_json (400) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 400 invalid_request mean on the Model API?invalid_request (400) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 400 unsupported_parameter mean?unsupported_parameter (400) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 401 account_mismatch mean?account_mismatch (401) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 401 expired_api_key mean?expired_api_key (401) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 401 invalid_api_key mean?invalid_api_key (401) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 401 missing_account_id mean?missing_account_id (401) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 402 out_of_credits mean?out_of_credits (402) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 403 account_suspended mean?account_suspended (403) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 403 insufficient_scope mean on the Model API?insufficient_scope (403) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 404 model_not_found mean?model_not_found (404) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 404 not_supported mean?not_supported (404) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 410 model_retired mean?model_retired (410) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 413 request_too_large mean?request_too_large (413) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does 429 rate_limited mean on the Model API?rate_limited (429) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does a Model API error look like?The JSON shape of Model API errors, the X-Request-Id header and how to branch on error codes.Reference
- What does empty_response mean?empty_response (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does model_overloaded mean?model_overloaded (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does model_timeout mean?model_timeout (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does model_unavailable mean?model_unavailable (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What does stream_error mean?stream_error (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
- What is X-Request-Id and why should I log it?Every Model API response has an X-Request-Id header. Log it so you and support can find a specific request.FAQ
- Which Model API errors should I retry?Retry 429 and 5xx errors with backoff; fix the request for 4xx errors. A simple rule set for your client.Reference
- Why do I get 400 unsupported_content?unsupported_content (400) on the Clatter Labs Model API: what it means, common causes and how to fix it.Troubleshooting
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.