VoiceCloneResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-voice-clone-response-schema.json",
  "title": "VoiceCloneResponse",
  "description": "Response envelope for a single voice clone.",
  "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/VoiceCloneResponse",
  "properties": {
    "data": {
      "$ref": "#/$defs/VoiceCloneData"
    }
  },
  "type": "object",
  "$defs": {
    "VoiceCloneData": {
      "description": "A voice clone object.",
      "properties": {
        "created_at": {
          "description": "Timestamp when the voice clone was created.",
          "format": "date-time",
          "type": "string"
        },
        "gender": {
          "description": "Gender of the voice clone.",
          "enum": [
            "male",
            "female",
            "neutral",
            null
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "description": "Unique identifier for the voice clone.",
          "format": "uuid",
          "type": "string"
        },
        "label": {
          "description": "Voice style description. If not explicitly set on upload, falls back to the source design's prompt text.",
          "type": [
            "string",
            "null"
          ]
        },
        "language": {
          "description": "ISO 639-1 language code of the voice clone.",
          "type": [
            "string",
            "null"
          ]
        },
        "model_id": {
          "description": "TTS model identifier for the voice clone.",
          "enum": [
            "Qwen3TTS",
            "Ultra",
            "speech-2.8-turbo"
          ],
          "type": "string"
        },
        "name": {
          "description": "Name of the voice clone.",
          "type": "string"
        },
        "provider": {
          "description": "Voice synthesis provider used for this clone.",
          "enum": [
            "telnyx",
            "minimax",
            "Telnyx",
            "Minimax"
          ],
          "type": "string"
        },
        "provider_supported_models": {
          "description": "List of TTS model identifiers supported by this clone's provider.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "provider_voice_id": {
          "description": "Provider-specific voice identifier used for TTS synthesis. May differ from the clone UUID depending on the provider and model.",
          "type": [
            "string",
            "null"
          ]
        },
        "record_type": {
          "description": "Identifies the resource type.",
          "enum": [
            "voice_clone"
          ],
          "type": "string"
        },
        "source_voice_design_id": {
          "description": "UUID of the source voice design. `null` for upload-based clones.",
          "format": "uuid",
          "type": [
            "string",
            "null"
          ]
        },
        "source_voice_design_version": {
          "description": "Version of the source voice design used. `null` for upload-based clones.",
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "description": "Clone status. pending for Ultra clones while on-prem import is in progress, active once ready, failed if verification timed out, expired if not kept alive.",
          "enum": [
            "active",
            "pending",
            "failed",
            "expired"
          ],
          "type": "string"
        },
        "updated_at": {
          "description": "Timestamp when the voice clone was last updated.",
          "format": "date-time",
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}