Error Codes
HTTP status codes and error payload format
| Status | Code | Meaning |
|---|---|---|
| 200 | OK | Request succeeded, result in data |
| 400 | BAD_REQUEST | Malformed request body or invalid model slug |
| 401 | UNAUTHORIZED | Missing or invalid Bearer token |
| 402 | INSUFFICIENT_CREDITS | Credit balance below cost of request |
| 404 | MODEL_NOT_FOUND | Unknown model slug (check /market) |
| 429 | RATE_LIMITED | Exceeded 20 req / 10s per key |
| 500 | UPSTREAM_ERROR | Upstream provider failure (retry with exponential backoff) |
| 503 | SERVICE_DEGRADED | Specific model provider is down; try an alternative model |