HTTP error codes
Status codes returned by the ASR and TTS APIs and what each one means.
Speech-to-Text (ASR)
| Status | Meaning |
|---|
| 200 | Success, audio or JSON body returned. |
| 400 | Bad request, missing or malformed fields. Response body: {"detail": "..."}. |
| 401 | Unauthorized, API key invalid or missing. |
| 422 | Synthesis / transcription error (invalid text or config). |
| 429 | Rate limit exceeded. Back off and retry. |
| 500 | Internal server error, unexpected server-side failure. |
| 503 | Service unavailable, Triton or Redis temporarily down. |
| 504 | Gateway timeout, request exceeded the processing window. |
Text-to-Speech (TTS)
| Status | Description |
|---|
| 200 | Success. Audio bytes in response body. |
| 400 | Missing or malformed fields. Body: {"detail": "..."}. |
| 401 | API key invalid or missing. |
| 422 | Invalid text or config. |
| 429 | Rate limited. |
| 500 | Internal server error. |
| 503 | Backend (Triton/Redis) temporarily unavailable. |
| 504 | Gateway timeout. |
