> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Clone API errors

> Reference for error codes returned by the Telnyx Voice Clone API, including general errors and provider-specific failures with troubleshooting tips.

## 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 |