API reference · Errors
Errors
Every error has a status, a code and a message.
{ "error": { "code": "INSUFFICIENT_CREDITS", "message": "No credits left; top up in the dashboard" } }| Status | Code | Meaning |
|---|---|---|
| 400 | VALIDATION_FAILED | A field is missing or wrong; the message says which. |
| 400 | CONTENT_BLOCKED | The text breaks the usage policy (scam scripts). |
| 400 | INVALID_AUDIO_INPUT | The audio could not be read. |
| 401 | UNAUTHORIZED | Missing or invalid API key. |
| 402 | INSUFFICIENT_CREDITS | The workspace has no credits left. |
| 402 | KEY_SPENDING_LIMIT | This key reached its monthly spending limit. |
| 403 | ACCOUNT_SUSPENDED | The account is suspended; contact us. |
| 413 | PAYLOAD_TOO_LARGE | The request body is too large. |
| 429 | RATE_LIMITED | Too many requests; wait retry-after seconds. |
| 502 | PROVIDER_FAILED | The speech provider failed; try again. |
| 503 | PROVIDER_UNAVAILABLE | The model is not available right now. |
| 504 | PROVIDER_TIMEOUT | The speech provider took too long. |
Retry 429 and 5xx errors with a short wait; the SDKs do this twice by default.