API reference
Errors & limits
Status codes, retry guidance, and platform limits.
Standard OpenAI-style error responses:
| Status | Meaning | Retry? |
|---|---|---|
401 | Missing or invalid API key | no — fix the key |
400 | Malformed request, or budget exceeded (top up to continue) | no |
429 | Rate limit hit | yes, with backoff |
5xx | Upstream provider issue | yes |
Error bodies follow the OpenAI shape:
json
{"error": {"message": "...","type": "invalid_request_error","code": "..."}}
Platform limits #
- Requests are limited to 60/s per IP at the edge.
- Request bodies up to 50 MB (plenty for base64 vision payloads).
- Streams stay open for up to 10 minutes.