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 | 422 | 10027 | File too large. Maximum allowed size is 5MB (20MB for Minimax) |
create_from_upload | 400 | 10015 | Failed to process audio file: <reason> (FFmpeg failure) |
create_from_upload | 422 | 10027 | Invalid provider+model_id combination |
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 |