Voice Clones

Create a voice clone from an audio file upload

Changed on

Creates a new voice clone by uploading an audio file directly. Supported formats: WAV, MP3, FLAC, OGG, M4A. Maximum file size: 20MB. Reference audio is trimmed per model: Qwen3TTS and Bayan use the first 10 seconds, Ultra uses up to 60 seconds, and Minimax accepts 10 seconds to 5 minutes. Ultra clones return 202 with status pending; all other models return 201 with status active. Bayan clones require ref_text (the exact transcript of the reference audio) and support ar (default) and en only.

post/voice_clones/from_upload

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/voice_clones/from_upload
  • Auth: HTTP bearer

Request body multipart/form-data

OR
OR
OR

Response

Voice clone created successfully from the uploaded audio.

Example response

{
  "data": {
    "record_type": "voice_clone",
    "id": "660f9511-f3ac-52e5-b827-557766551111",
    "source_voice_design_id": "550e8400-e29b-41d4-a716-446655440000",
    "source_voice_design_version": 1,
    "name": "clone-narrator",
    "language": "en",
    "gender": "male",
    "label": "Speak in a warm, friendly tone",
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z",
    "provider": "Telnyx",
    "provider_supported_models": [
      "Qwen3TTS"
    ],
    "provider_voice_id": "660f9511-f3ac-52e5-b827-557766551111",
    "model_id": "Qwen3TTS",
    "status": "active"
  }
}

Changes

  • 118614177fa4Revision changes
    • warning

      added the new Bayan enum value to the / response property for the response status

    • warning

      added the new Bayan enum value to the / response property for the response status

    • info

      added to the request body oneOf list

    • info

      added the non-success response with the status