Status Codes
Voice AI endpoints use standard HTTP status codes. Public endpoints are
rate-limited per IP and return 429 when the daily quota is exceeded.
Response codes
| Code | Status | Description |
|---|---|---|
| 200 | OK | The request was successful and the response contains the requested data. |
| 400 | Bad Request | The request was invalid or malformed, including when the audio file is too large. |
| 409 | Conflict | The request could not be processed, for example when your account has insufficient balance. |
| 429 | Too Many Requests | The daily limit of AI model requests for your IP address has been reached. |
| 500 | Server Error | An unexpected error occurred on the server. |
Hitting 429 on a public endpoint? Switch to an authenticated request with a bearer
token for higher limits.
Response envelope
Every Voice AI response is wrapped in a common envelope. On success, data holds the result and error is null. On failure, data is null and error carries the details.
{
"code": 200,
"data": {
"generated_audio_url": "path/file_name.wav"
},
"error": null,
"object": "tts",
"status": "success"
}