Pre-recorded Audio — Error Handling
Exception Types
All SDK exceptions inherit from ShunyalabsError.
Exception hierarchy
ShunyalabsError
├── AuthenticationError # 401
├── PermissionDeniedError # 403
├── NotFoundError # 404
├── RateLimitError # 429
├── TranscriptionError # 422
├── ServerError # 5xx
├── TimeoutError
└── ConnectionError
Exception reference
| Exception | HTTP Status | Description |
|---|---|---|
AuthenticationError | 401 | Invalid or missing API key. |
PermissionDeniedError | 403 | API key lacks required permissions. |
NotFoundError | 404 | Requested resource not found. |
RateLimitError | 429 | Rate limit exceeded. Back off and retry. |
TranscriptionError | 422 | Invalid audio or configuration. |
ServerError | 5xx | Transient server error. Safe to retry. |
TimeoutError | — | Request exceeded configured timeout. |
ConnectionError | — | Network connectivity failure. |