General Errors
These errors apply to all providers.| Endpoint | Status | Code | Detail |
|---|---|---|---|
show | 404 | 10005 | Clone not found or invalid UUID |
create | 404 | 10005 | Voice design not found / no version |
create | 409 | 10012 | Duplicate provider_voice_id |
create | 422 | 10027 | Changeset validation (see below) |
create_from_upload | 422 | 10027 | audio_file is required |
create_from_upload | 413 | 10015 | File too large. Maximum allowed size is 20MB. or Request body exceeds the maximum allowed size of 20 MB. |
create_from_upload | 400 | 10015 | Failed to process audio file: <reason> (FFmpeg failure) |
create_from_upload | 422 | 10027 | Invalid provider+model_id combination |
create_from_upload | 422 | 10027 | Unsupported language for the model (for example, Bayan accepts only ar and en); source.pointer is /language |
create_from_upload | 422 | 10027 | Resemble language missing for model_id Pro, or not supported by the model (for example, Turbo with a non-English code or Urdu with a code other than ur); source.pointer is /language |
create_from_upload | 422 | 10027 | ref_text is required for model_id Bayan: provide the exact transcript of the reference audio (missing, empty, or whitespace-only ref_text); source.pointer is /ref_text |
update | 404 | 10005 | Clone not found |
update | 422 | 10027 | Changeset validation errors |
delete | 404 | 10005 | Clone not found |
sample | 404 | 10005 | Clone or sample not found |
Telnyx / Cartesia Errors
| Status | Code | Detail | Provider |
|---|---|---|---|
| 422 | 10027 | Pattern-matched messages (voice not found, audio too short/long, bad quality, unsupported format, unsupported language, invalid params, text length invalid) | Telnyx/Cartesia |
| 429 | 10011 | Provider rate limit exceeded | All providers |
Minimax Errors
| Status | Code | Detail | Provider |
|---|---|---|---|
| 422 | 10038 | Audio is too short (min 10s) | Minimax (code 2037) |
| 422 | 10038 | Audio is too long | Minimax (code 2038) |
| 422 | 10038 | Audio quality too low | Minimax (code 2039) |
| 422 | 10038 | Audio contains too much noise | Minimax (code 2048) |
| 422 | 10038 | Voice cloning provider error: <msg> | Minimax (other codes) |
| 500 | 10037 | Voice clone service configuration error | Auth misconfiguration detected |
| 502 | 10037 | Voice clone service unavailable | Upstream error or connection failure |