Errors
All errors share one shape:
{ "error": { "type": "invalid_request_error", "message": "…", "code": "missing_model" } }
| HTTP | type | When |
|---|---|---|
| 400 | invalid_request_error | Malformed body, unknown parameter, bad model id |
| 401 | authentication_error | Missing/invalid/revoked key |
| 402 | budget_exceeded | Credit balance exhausted |
| 403 | permission_error | Model group not allowed on your plan |
| 404 | not_found_error | Unknown job id, file id |
| 413 | payload_too_large | Inline input over 4 MB — use POST /v1/files |
| 429 | rate_limit_error | Requests/min or tokens/day exceeded; honor Retry-After |
| 503 | model_cold | Cold model warming up; retry after Retry-After seconds |
| 5xx | api_error | Our side; retry with exponential backoff |