Error codes
Diagnose authentication, billing, validation, and server errors.
Errors use the same { code, msg, data } envelope as successful responses. The msg field contains the actionable reason.
| Code | Meaning | What to do |
|---|---|---|
401 | Missing or invalid API key | Check the Authorization header |
402 | Insufficient credits | Top up and retry; the message states required and available credits |
403 | Account suspended | Contact support |
404 | Task not found | Check taskId; customers can read only their own tasks |
422 | Invalid parameter | Correct the request according to msg |
429 | Rate limit exceeded | Wait for the number of seconds in the Retry-After header, then retry |
500 | Server or upstream error | Retry later; submitted tasks that fail are refunded |
Rate limit
Each account can create at most 20 tasks per 10 seconds through createTask. The limit is shared by all API keys under the account. Requests over the limit return 429 with a Retry-After header. They are not queued and not charged. Querying tasks with recordInfo is not rate limited.
If you hit 429 regularly, contact us to request a higher limit.
Retry guidance
Retry transient 500 responses with exponential backoff. Retry 429 after the Retry-After delay. Do not retry 401, 402, 403, or 422 until the underlying request or account issue is fixed.