VoiceCloneRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-voice-clone-request-schema.json",
  "title": "VoiceCloneRequest",
  "description": "Request body for creating a voice clone from an existing voice design.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-voice-clones-api-openapi.yml#/components/schemas/VoiceCloneRequest",
  "oneOf": [
    {
      "$ref": "#/$defs/TelnyxDesignClone"
    },
    {
      "$ref": "#/$defs/MinimaxDesignClone"
    }
  ],
  "$defs": {
    "MinimaxDesignClone": {
      "description": "Create a voice clone from a voice design using the Minimax provider.",
      "properties": {
        "gender": {
          "description": "Gender of the voice clone.",
          "enum": [
            "male",
            "female",
            "neutral"
          ],
          "type": "string"
        },
        "language": {
          "description": "ISO 639-1 language code for the clone. Supports the Minimax language set.",
          "type": "string"
        },
        "name": {
          "description": "Name for the voice clone.",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "provider": {
          "description": "Voice synthesis provider. Must be `minimax`.",
          "enum": [
            "minimax",
            "Minimax"
          ],
          "type": "string"
        },
        "voice_design_id": {
          "description": "UUID of the source voice design to clone.",
          "format": "uuid",
          "type": "string"
        }
      },
      "required": [
        "name",
        "voice_design_id",
        "language",
        "gender",
        "provider"
      ],
      "type": "object"
    },
    "TelnyxDesignClone": {
      "description": "Create a voice clone from a voice design using the Telnyx provider.",
      "properties": {
        "gender": {
          "description": "Gender of the voice clone.",
          "enum": [
            "male",
            "female",
            "neutral"
          ],
          "type": "string"
        },
        "language": {
          "description": "ISO 639-1 language code for the clone. Supports the combined Telnyx language set.",
          "type": "string"
        },
        "name": {
          "description": "Name for the voice clone.",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "provider": {
          "default": "telnyx",
          "description": "Voice synthesis provider. Defaults to `telnyx`.",
          "enum": [
            "telnyx",
            "Telnyx"
          ],
          "type": "string"
        },
        "voice_design_id": {
          "description": "UUID of the source voice design to clone.",
          "format": "uuid",
          "type": "string"
        }
      },
      "required": [
        "name",
        "voice_design_id",
        "language",
        "gender"
      ],
      "type": "object"
    }
  }
}