Reference
Errors & limits
Errors are returned as a JSON object with an HTTP status; requests are rate limited per API key.
Every error response is { "error": "code" }. Common codes:
| Field | Type | Description |
|---|---|---|
| api_key_required | 401 | The request was not authenticated with an API key. |
| unauthorized | 401 | The API key is missing, invalid, or disabled. |
| insufficient_scope | 403 | The key lacks the scope this endpoint requires. |
| subscription_required | 402 | No active plan or trial. |
| insufficient_credits | 402 | Not enough credits to start the job. |
| not_found | 404 | The resource does not exist or isn't yours. |
| job_not_deletable | 409 | Only failed jobs can be deleted. |
| invalid_request | 400 | The request body or query failed validation. |
| rate_limited | 429 | Too many requests — see Retry-After. |
| internal_error | 500 | Unexpected server error. |
Requests are rate limited per API key (120/minute by default). When throttled, the response is 429 with a Retry-After header (seconds). Successful responses include x-ratelimit-remaining.