Telnyx · Schema
VoiceCloneUploadRequest
Multipart form data for creating a voice clone from a direct audio upload. Maximum file size: 5MB for Telnyx, 20MB for Minimax.
CommunicationsCPaaSVoiceSMSIoTTelecommunicationsMessagingArtificial IntelligenceMCPVoice AIPhone NumbersInferenceNumber VerificationPhone VerificationOTP2FALookupVerifyNumber LookupCNAMIdentityFraud Prevention
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-voice-clone-upload-request-schema.json",
"title": "VoiceCloneUploadRequest",
"description": "Multipart form data for creating a voice clone from a direct audio upload. Maximum file size: 5MB for Telnyx, 20MB for Minimax.",
"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/VoiceCloneUploadRequest",
"oneOf": [
{
"$ref": "#/$defs/TelnyxQwen3TTSClone"
},
{
"$ref": "#/$defs/TelnyxUltraClone"
},
{
"$ref": "#/$defs/MinimaxClone"
}
],
"$defs": {
"MinimaxClone": {
"description": "Upload-based voice clone using the Minimax provider.",
"properties": {
"audio_file": {
"description": "Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A. For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum size: 20MB.",
"format": "binary",
"type": "string"
},
"gender": {
"description": "Gender of the voice clone.",
"enum": [
"male",
"female",
"neutral"
],
"type": "string"
},
"label": {
"description": "Optional custom label describing the voice style.",
"type": "string"
},
"language": {
"description": "ISO 639-1 language code from the Minimax language set.",
"pattern": "^([Aa]uto|[a-z]{2,3}(-[A-Za-z0-9]{2,8})*)$",
"type": "string"
},
"model_id": {
"description": "TTS model identifier. Nullable — defaults to speech-2.8-turbo.",
"enum": [
"speech-2.8-turbo",
null
],
"type": [
"string",
"null"
]
},
"name": {
"description": "Name for the voice clone.",
"maxLength": 255,
"type": "string"
},
"provider": {
"description": "Voice synthesis provider. Must be `minimax`.",
"enum": [
"minimax",
"Minimax"
],
"type": "string"
},
"ref_text": {
"description": "Optional transcript of the audio file. Providing this improves clone quality.",
"type": "string"
}
},
"required": [
"audio_file",
"name",
"language",
"gender",
"provider"
],
"type": "object"
},
"TelnyxQwen3TTSClone": {
"description": "Upload-based voice clone using the Telnyx Qwen3TTS model (default).",
"properties": {
"audio_file": {
"description": "Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A. For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum size: 5MB.",
"format": "binary",
"type": "string"
},
"gender": {
"description": "Gender of the voice clone.",
"enum": [
"male",
"female",
"neutral"
],
"type": "string"
},
"label": {
"description": "Optional custom label describing the voice style.",
"type": "string"
},
"language": {
"description": "ISO 639-1 language code from the Qwen language set.",
"pattern": "^([Aa]uto|[a-z]{2,3}(-[A-Za-z0-9]{2,8})*)$",
"type": "string"
},
"model_id": {
"description": "TTS model identifier. Nullable/omittable — defaults to Qwen3TTS.",
"enum": [
"Qwen3TTS",
null
],
"type": [
"string",
"null"
]
},
"name": {
"description": "Name for the voice clone.",
"maxLength": 255,
"type": "string"
},
"provider": {
"description": "Voice synthesis provider. Must be `telnyx`.",
"enum": [
"telnyx",
"Telnyx"
],
"type": "string"
},
"ref_text": {
"description": "Optional transcript of the audio file. Providing this improves clone quality.",
"type": "string"
}
},
"required": [
"audio_file",
"name",
"language",
"gender",
"provider"
],
"type": "object"
},
"TelnyxUltraClone": {
"description": "Upload-based voice clone using the Telnyx Ultra model.",
"properties": {
"audio_file": {
"description": "Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A. For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum size: 5MB.",
"format": "binary",
"type": "string"
},
"gender": {
"description": "Gender of the voice clone.",
"enum": [
"male",
"female",
"neutral"
],
"type": "string"
},
"label": {
"description": "Optional custom label describing the voice style.",
"type": "string"
},
"language": {
"description": "ISO 639-1 language code from the Ultra language set (40 languages).",
"pattern": "^([Aa]uto|[a-z]{2,3}(-[A-Za-z0-9]{2,8})*)$",
"type": "string"
},
"model_id": {
"description": "TTS model identifier. Must be `Ultra`.",
"enum": [
"Ultra"
],
"type": "string"
},
"name": {
"description": "Name for the voice clone.",
"maxLength": 255,
"type": "string"
},
"provider": {
"description": "Voice synthesis provider. Must be `telnyx`.",
"enum": [
"telnyx",
"Telnyx"
],
"type": "string"
},
"ref_text": {
"description": "Optional transcript of the audio file. Providing this improves clone quality.",
"type": "string"
}
},
"required": [
"audio_file",
"name",
"language",
"gender",
"model_id",
"provider"
],
"type": "object"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/telnyx-voice-clone-upload-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.