Voice cloning parameters. Providing this field helps improve the similarity and stability of synthesized voice. If used, you must also upload a short sample audio clip (less than 8s, supported formats: mp3, m4a, wav) along with its corresponding transcript.
Optional preview text, up to 1000 characters. The cloned voice will be used to read the text, and an audio preview link will be returned.
Note: Preview requests are charged based on character count, consistent with T2A pricing.
Interjection tags: Only supported when using speech-2.8-hd or speech-2.8-turbo models. Supported interjections: (laughs), (chuckle), (coughs), (clear-throat), (groans), (breath), (pant), (inhale), (exhale), (gasps), (sniffs), (sighs), (snorts), (burps), (lip-smacking), (humming), (hissing), (emm), (whistles), (sneezes), (crying), (applause).
Controls whether recognition for specific minority languages and dialects is enhanced. Default is null. If the language type is unknown, set to "auto" and the model will automatically detect it.
Optional. The expected transcript of the cloning sample audio (matching the content of file_id or clone_prompt.prompt_audio). When provided, the audio is sent to ASR and the recognized text is compared against text_validation. If the similarity is below accuracy, the request is rejected with status code 1043 (The asr similarity check failed). Maximum length: 200 characters.
Optional. Similarity threshold used by the ASR validation triggered by text_validation. Valid range: [0, 1]. When omitted or set to 0, defaults to 0.7.
Preview audio metadata and billing info. Returned only when text is provided (i.e. preview synthesis happened and was billed). Field shape is aligned with /v1/t2a_v2.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MiniMax API Docs","colors":{"primary":"#181E25","dark":"#181E25"},"logo":{"light":"https://mintcdn.com/minimax-cac98058/XYzsL2L2ynonu2Q_/logo/light.svg?fit=max\u0026auto=format\u0026n=XYzsL2L2ynonu2Q_\u0026q=85\u0026s=9c99bb2678d62388d8a4e7cce1750858","dark":"https://mintcdn.com/minimax-cac98058/XYzsL2L2ynonu2Q_/logo/dark.svg?fit=max\u0026auto=format\u0026n=XYzsL2L2ynonu2Q_\u0026q=85\u0026s=e62ef6e36d7512de91c8c48322614594","href":"https://minimax.io"},"favicon":"https://mintcdn.com/minimax-cac98058/3KE0RwwD41Lh3xt2/favicon.ico?fit=max\u0026auto=format\u0026n=3KE0RwwD41Lh3xt2\u0026q=85\u0026s=6a58247013972686c0a551c6c6b98d66","api":{"examples":{"prefill":true}},"appearance":{"default":"system","strict":false},"navbar":{"primary":{"type":"button","label":"Console","href":"https://platform.minimax.io/console/home"}},"footer":{"socials":{"discord":"https://www.minimax.io/discord","x":"https://x.com/MiniMax_AI","linkedin":"https://www.linkedin.com/company/minimax-ai","github":"https://github.com/MiniMax-AI"},"links":[{"header":"Research","items":[{"label":"MiniMax M3","href":"https://www.minimax.io/models/text/m3"},{"label":"MiniMax M2-her","href":"https://www.minimax.io/news/a-deep-dive-into-the-minimax-m2-her-2"},{"label":"MiniMax M2.1","href":"https://www.minimax.io/news/minimax-m21"},{"label":"MiniMax Speech 2.8","href":"https://www.minimax.io/news/minimax-speech-28"},{"label":"MiniMax H3","href":"https://www.minimax.io/blog/minimax-h3"},{"label":"MiniMax Music 3.0","href":"https://platform.minimax.io/docs/guides/music-generation"}]},{"header":"Product","items":[{"label":"MiniMax Code","href":"https://agent.minimax.io/download"},{"label":"MiniMax Design","href":"https://design.minimax.io/"},{"label":"Audio","href":"https://www.minimax.io/audio"},{"label":"Talkie","href":"https://www.talkie-ai.com/"}]},{"header":"API","items":[{"label":"Developer Docs","href":"https://platform.minimax.io/docs/guides/models-intro"},{"label":"M Plan","href":"https://platform.minimax.io/subscribe/token-plan"},{"label":"Pricing","href":"https://platform.minimax.io/docs/pricing/overview"},{"label":"Console Login","href":"https://platform.minimax.io/console/personal-info"},{"label":"Developer Program","href":"https://platform.minimax.io/activity/contact-us-en"}]},{"header":"Recommended","items":[{"label":"Model Introduction","href":"https://platform.minimax.io/docs/guides/models-intro"},{"label":"Text Generation","href":"https://platform.minimax.io/docs/guides/text-generation"},{"label":"M3 for AI Coding Tools","href":"https://platform.minimax.io/docs/token-plan/openclaw"},{"label":"Text to Speech","href":"https://platform.minimax.io/docs/guides/speech-t2a-websocket"},{"label":"Video Generation","href":"https://platform.minimax.io/docs/guides/video-generation"}]}]},"seo":{"metatags":{"title":"MiniMax API Docs","description":"MiniMax Open Platform developer documentation with model API references, integration guides, tool setup, and billing information for building AI applications.","charset":"UTF-8","canonical":"https://platform.minimax.io/docs","viewport":"width=device-width, initial-scale=1.0"},"indexing":"all"},"fonts":{"family":"DM Sans"},"icons":{"library":"lucide"},"integrations":{"telemetry":{"enabled":true},"cookies":{"key":"minimax_docs_feedback_consent","value":"v1:granted"}},"banner":{"content":"🎉 The new-generation MiniMax M3.1 Flash is now available! ➔ [View docs](/docs/guides/text-generation).","dismissible":true},"contextual":{"options":["copy","view","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"minimax-cac98058","hasAudioNarration":false,"actualSubdomain":"minimax-cac98058","customDomains":["platform.minimax.io"],"gitSource":{"type":"github","owner":"minimax-ai-dev","repo":"docs","deployBranch":"main","contentDirectory":"packages/docs-en","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9d77622dab27fc6c05761","collectionId":"a69a3165-c507-466a-b805-95a281f71a8c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9d77622dab27fc6c05761"},"feedback":{"issues":false,"thumbs":true,"edits":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae9d77622dab27fc6c05761","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API","count":45},{"language":"default","tag":"Developer Guides","count":32},{"language":"default","tag":"Use Guides","count":22},{"language":"default","tag":"M Plan","count":18},{"language":"default","tag":"Speech","count":17},{"language":"default","tag":"Text","count":14},{"language":"default","tag":"Video","count":14},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Tools","count":9},{"language":"default","tag":"Video Generation","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":false},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".audio-container{height:50px;margin:16px 0}.video-agent-templates{width:300px;height:180px;object-fit:cover}video{border-radius:12px}table{overflow-x:auto}th,td{vertical-align:middle!important}td .video-agent-templates{margin:0}#navbar .docs-platform-brand{display:inline-flex;align-items:center;flex-shrink:0}#navbar .docs-platform-name{margin-left:20px;padding-left:20px;border-left:1px solid #e5e7eb;color:#6b7280;font-size:14px;font-weight:400;line-height:20px;white-space:nowrap}.dark #navbar .docs-platform-name{border-color:#374151;color:#9ca3af}#topbar-cta-button>a>span,#navbar .docs-console-mobile>span{background-color:#242424;border-radius:8px}#topbar-cta-button>a:hover>span,#navbar .docs-console-mobile:hover>span{background-color:#3a3a3a}#navbar .docs-console-mobile{display:none}#navbar nav:has(#topbar-cta-button){margin-right:0}@media (max-width: 1023px){#navbar .docs-platform-name{margin-left:12px;padding-left:12px;font-size:12px}#navbar .docs-console-mobile{position:relative;display:inline-flex;align-items:center;flex-shrink:0;padding:8px 10px;font-size:12px;font-weight:500;white-space:nowrap}}@media (max-width: 480px){#navbar .docs-topbar-row{column-gap:4px}#navbar .docs-platform-brand .nav-logo{width:80px;height:auto}#navbar .docs-platform-name{max-width:60px;margin-left:8px;padding-left:8px;font-size:11px;line-height:14px;white-space:normal}#navbar .docs-console-mobile{padding:8px;font-size:11px}#navbar :has(>#search-bar-entry-mobile){gap:6px}#navbar #search-bar-entry-mobile{width:24px}}#content-container p{font-size:1rem;line-height:1.5rem}.eyebrow{text-transform:uppercase}.method-nav-pill>span{font-weight:400}*:has(>.method-pill){border:none}.navbar-link>a{font-weight:400}.nav-tabs-item{font-weight:400}.nav-tabs-item.text-gray-800{font-weight:500}*:has(>.navbar-link)>.navbar-link:first-child>a{color:#181e25;font-weight:500}.dark *:has(>.navbar-link)>.navbar-link:first-child>a{color:#fff}#navbar,#sidebar{letter-spacing:0.02em}.callout{margin-top:2rem;margin-bottom:2rem}#content:has(>.model-retirement-notice:first-child){margin-top:1rem}.callout.model-retirement-notice{margin-top:0}.video-package-alert{display:flex;width:100%;box-sizing:border-box;gap:12px;align-items:flex-start;padding:16px 18px;margin:12px 0 24px;border:1px solid #fde68a;border-radius:10px;background:#fffbeb}.video-package-alert__icon{display:grid;flex:0 0 auto;width:24px;height:24px;place-items:center;border-radius:6px;color:#d97706;background:#fef3c7}.video-package-alert__content{min-width:0}.video-package-alert__title{margin-bottom:4px;color:#b45309;font-size:14px;font-weight:600;line-height:20px}.video-package-alert__desc{color:#3f3f3f;font-size:14px;font-weight:400;line-height:20px}.video-package-alert__desc a,.video-package-alert__desc a:hover{color:#b45309!important;font-weight:600!important;text-decoration-line:underline!important;text-decoration-color:#b45309!important;text-decoration-thickness:2px;text-underline-offset:3px;border-bottom:0!important;box-shadow:none!important;transition:none}.video-package-alert__desc a:focus-visible{border-radius:3px;outline:2px solid #d97706;outline-offset:2px}.dark .video-package-alert{border-color:rgba(245, 158, 11, 0.45);background:rgba(120, 53, 15, 0.22)}.dark .video-package-alert__icon{color:#fbbf24;background:rgba(180, 83, 9, 0.32)}.dark .video-package-alert__title{color:#fcd34d}.dark .video-package-alert__desc{color:#e5e7eb}.dark .video-package-alert__desc a{color:#fbbf24!important;text-decoration-color:#fbbf24!important}@media (max-width: 640px){.video-package-alert{gap:10px;padding:14px}}.card span{line-height:1.4rem;margin-top:8px!important}#banner a{border-bottom-color:#181E25;color:#FFF}#footer a[href=\"mailto:api@minimax.io\"] svg{-webkit-mask-image:url('https://filecdn.minimax.chat/public/45f6ad6e-f42e-45ed-938e-7de67bfd367f.svg')!important;mask-image:url('https://filecdn.minimax.chat/public/45f6ad6e-f42e-45ed-938e-7de67bfd367f.svg')!important}#sidebar:has(a[href$=\"/pricing/overview\"]),#sidebar:has(a[href$=\"/pricing/overview/\"]){visibility:hidden}.pricing-sidebar-navigation{display:none}@media (min-width: 1024px){#content:has([data-pricing-sidebar]){container-type:normal;contain:none;isolation:auto}.pricing-sidebar-navigation{--pricing-sidebar-top: calc(var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px));display:block;position:fixed;z-index:20;top:var(--pricing-sidebar-top);left:max(2rem, calc((100vw - 92rem) / 2 + 2rem));width:var(--sidebar-width, 18rem);height:calc(100dvh - var(--pricing-sidebar-top));box-sizing:border-box;overflow-y:auto;overscroll-behavior:contain;padding:40px 24px 32px 0;margin:0}}[data-pricing-overview-active] [data-pricing-original]{display:none!important}.pricing-anchor-navigation{font-size:14px;line-height:1.5}.pricing-navigation-group+.pricing-navigation-group{margin-top:28px}.pricing-navigation-title{display:block;margin:0 0 10px;padding-left:16px;color:#111827;font-size:inherit;font-weight:600;line-height:1.5}.pricing-anchor-navigation .pricing-anchor-link{display:block;padding:6px 12px 6px 16px;margin:1px 0;border:0;border-radius:12px;color:#374151;line-height:1.5;text-decoration:none;overflow-wrap:anywhere}.pricing-anchor-navigation .pricing-anchor-link:hover{background:rgba(75, 85, 99, .05);color:#111827}.pricing-anchor-navigation .pricing-anchor-link[aria-current=\"location\"]{background:rgba(24, 30, 37, .075);color:#181e25;font-weight:600}.pricing-anchor-link:focus-visible{outline:2px solid currentColor;outline-offset:-2px}.pricing-section-toc{font-size:14px;line-height:1.5}.pricing-toc-title{margin-bottom:12px;color:#374151;font-weight:500}.pricing-section-toc .pricing-anchor-link{display:block;border:0;padding:5px 0 5px 12px;border-left:1px solid #e5e7eb;color:#6b7280;text-decoration:none;overflow-wrap:anywhere}.pricing-section-toc .pricing-anchor-link[aria-current=\"location\"]{border-left:2px solid #181e25;color:#181e25;font-weight:500}.pricing-mobile-navigation{display:none}#pricing-document .pricing-section,#pricing-document .pricing-section [id]{scroll-margin-top:10rem}.dark .pricing-navigation-title,.dark .pricing-toc-title{color:#e5e7eb}.dark .pricing-anchor-navigation .pricing-anchor-link,.dark .pricing-section-toc .pricing-anchor-link{color:#9ca3af}.dark .pricing-anchor-navigation .pricing-anchor-link:hover{background:rgba(229, 231, 235, .05);color:#d1d5db}.dark .pricing-anchor-navigation .pricing-anchor-link[aria-current=\"location\"]{background:rgba(229, 231, 235, .1);color:#f3f4f6}.dark .pricing-section-toc .pricing-anchor-link{border-left-color:#374151}.dark .pricing-section-toc .pricing-anchor-link[aria-current=\"location\"]{border-left-color:#e5e7eb;color:#e5e7eb}@media (max-width: 1023px){#pricing-document .pricing-mobile-navigation{display:block;margin:0 0 24px}#pricing-document .pricing-mobile-navigation>.accordion{margin-bottom:0}#pricing-document .pricing-mobile-navigation .pricing-anchor-navigation{max-height:min(65vh, 560px);overflow-y:auto;padding:8px 12px 20px;overscroll-behavior:contain}}#pricing-document>.pricing-section{margin-top:56px;padding-top:40px;border-top:1px solid #e5e7eb}#pricing-document>.pricing-overview+.pricing-section{margin-top:36px;border-top:0}#pricing-document>.pricing-section>h2:first-child{margin-top:0}#pricing-document .pricing-overview>span[data-as=\"p\"],#pricing-document .pricing-section>span[data-as=\"p\"]{display:block;margin:1em 0}.dark #pricing-document>.pricing-section{border-color:#374151}@media (max-width: 767px){#pricing-document>.pricing-section{margin-top:40px;padding-top:28px}}#pricing-document section[id=\"models/text\"] table{table-layout:fixed;width:100%}#pricing-document section[id=\"models/text\"] table th:first-child,#pricing-document section[id=\"models/text\"] table td:first-child{width:32%}#pricing-document section[id=\"models/video\"] table{table-layout:fixed;width:100%}#pricing-document section[id=\"models/video\"] table th:first-child,#pricing-document section[id=\"models/video\"] table td:first-child{width:30%}#pricing-document .video-price-table,#pricing-document .video-task-table{display:table;table-layout:fixed;width:100%}#pricing-document .video-price-table td:has(>strong)+td,#pricing-document .video-price-table tbody tr:not(:has(strong))>td:first-child{padding-left:24px}#pricing-document .video-price-table thead th:nth-child(2){padding-left:24px}.restricted-doc{--restricted-border: rgba(15, 23, 42, .12);--restricted-border-strong: rgba(15, 23, 42, .18);--restricted-muted: #64748b;--restricted-surface: rgba(15, 23, 42, .035);--restricted-surface-hover: rgba(15, 23, 42, .055);--restricted-link: #2563eb;color:inherit}.dark .restricted-doc{--restricted-border: rgba(255, 255, 255, .12);--restricted-border-strong: rgba(255, 255, 255, .18);--restricted-muted: #94a3b8;--restricted-surface: rgba(255, 255, 255, .045);--restricted-surface-hover: rgba(255, 255, 255, .07);--restricted-link: #60a5fa}.restricted-doc-loading{min-height:12rem;display:flex;align-items:center;justify-content:center}.restricted-doc-spinner{width:1.75rem;height:1.75rem;border:2px solid rgba(98,112,132,.24);border-top-color:#627084;border-radius:50%;animation:restricted-doc-spin .75s linear infinite}@keyframes restricted-doc-spin{to{transform:rotate(360deg)}}@media (prefers-reduced-motion: reduce){.restricted-doc-spinner{animation-duration:1.5s}}.restricted-doc>h1{margin:0 0 .75rem;font-size:2.25rem;line-height:1.2;font-weight:700;letter-spacing:-.025em}.restricted-doc-description{margin:0 0 2rem;color:var(--restricted-muted);font-size:1.05rem;line-height:1.7}.restricted-doc h2,.restricted-doc h3,.restricted-doc h4{scroll-margin-top:6rem;font-weight:650;letter-spacing:-.015em}.restricted-doc h2{margin:2.75rem 0 1rem;padding-top:.25rem;font-size:1.65rem;line-height:1.35}.restricted-doc h3{margin:2.1rem 0 .75rem;font-size:1.3rem;line-height:1.4}.restricted-doc h4{margin:1.6rem 0 .5rem;font-size:1.1rem;line-height:1.45}.restricted-doc>p{margin:1rem 0}.restricted-doc p,.restricted-doc li{line-height:1.75}.restricted-doc ul,.restricted-doc ol{margin:1rem 0;padding-left:1.5rem}.restricted-doc li{padding-left:.15rem}.restricted-doc li+li{margin-top:.3rem}.restricted-doc li>p{margin:.25rem 0}.restricted-doc a{color:var(--restricted-link);text-decoration:underline;text-decoration-color:color-mix(in srgb, var(--restricted-link) 35%, transparent);text-underline-offset:.2em}.restricted-doc a:hover{text-decoration-color:currentColor}.restricted-doc :not(pre)>code{padding:.15rem .4rem;border:1px solid var(--restricted-border);border-radius:.35rem;background:var(--restricted-surface);font-size:.875em;font-weight:500}.restricted-doc-table-wrap{max-width:100%;margin:1.5rem 0;overflow-x:auto;border:1px solid var(--restricted-border-strong);border-radius:.75rem}.restricted-doc table{width:100%;border-collapse:separate;border-spacing:0;font-size:.925rem;line-height:1.55}.restricted-doc th,.restricted-doc td{min-width:7rem;padding:.75rem 1rem;border-bottom:1px solid var(--restricted-border);vertical-align:top;text-align:left}.restricted-doc th+th,.restricted-doc td+td{border-left:1px solid var(--restricted-border)}.restricted-doc th{background:var(--restricted-surface);font-weight:600;color:inherit}.restricted-doc tbody tr{transition:background-color .15s ease}.restricted-doc tbody tr:hover{background:var(--restricted-surface-hover)}.restricted-doc tr:last-child td{border-bottom:0}.restricted-doc-code{position:relative;margin:1.5rem 0;border:1px solid rgba(255,255,255,.09);border-radius:.75rem;background:#0f172a;color:#e5e7eb;box-shadow:0 1px 2px rgba(15,23,42,.08);overflow:hidden}.restricted-doc-code pre{margin:0;padding:1.1rem 1.2rem;overflow-x:auto;background:transparent}.restricted-doc-code code{display:block;min-width:max-content;padding-right:3.5rem;font-size:.85rem;line-height:1.7;white-space:pre;tab-size:2}.restricted-doc-code button{position:absolute;z-index:1;top:.65rem;right:.65rem;padding:.3rem .6rem;border:1px solid rgba(255,255,255,.16);border-radius:.4rem;background:rgba(30,41,59,.92);color:#cbd5e1;font-size:.75rem;line-height:1.25rem;cursor:pointer;transition:color .15s ease, border-color .15s ease, background-color .15s ease}.restricted-doc-code button:hover{border-color:rgba(255,255,255,.28);background:#334155;color:#fff}.restricted-doc-code .hljs-comment,.restricted-doc-code .hljs-quote{color:#7f8ea3;font-style:italic}.restricted-doc-code .hljs-keyword,.restricted-doc-code .hljs-selector-tag,.restricted-doc-code .hljs-literal,.restricted-doc-code .hljs-section,.restricted-doc-code .hljs-link{color:#c792ea}.restricted-doc-code .hljs-string,.restricted-doc-code .hljs-title,.restricted-doc-code .hljs-name,.restricted-doc-code .hljs-type,.restricted-doc-code .hljs-attribute,.restricted-doc-code .hljs-symbol,.restricted-doc-code .hljs-bullet,.restricted-doc-code .hljs-addition,.restricted-doc-code .hljs-variable,.restricted-doc-code .hljs-template-tag,.restricted-doc-code .hljs-template-variable{color:#addb67}.restricted-doc-code .hljs-number,.restricted-doc-code .hljs-meta,.restricted-doc-code .hljs-built_in,.restricted-doc-code .hljs-builtin-name,.restricted-doc-code .hljs-params{color:#f78c6c}.restricted-doc-code .hljs-attr,.restricted-doc-code .hljs-selector-id,.restricted-doc-code .hljs-selector-class,.restricted-doc-code .hljs-selector-attr,.restricted-doc-code .hljs-selector-pseudo{color:#ffcb6b}.restricted-doc-code .hljs-function,.restricted-doc-code .hljs-class .hljs-title{color:#82aaff}.restricted-doc-code .hljs-regexp,.restricted-doc-code .hljs-deletion{color:#ff5370}.restricted-doc-code .hljs-emphasis{font-style:italic}.restricted-doc-code .hljs-strong{font-weight:700}.restricted-doc-callout{margin:1.5rem 0;padding:.9rem 1rem;border:1px solid rgba(59,130,246,.22);border-radius:.65rem;background:rgba(59,130,246,.07)}.restricted-doc-callout>:first-child{margin-top:0}.restricted-doc-callout>:last-child{margin-bottom:0}.restricted-doc blockquote{margin:1.5rem 0;padding:.1rem 0 .1rem 1.1rem;border-left:2px solid var(--restricted-border-strong);color:var(--restricted-muted);font-style:italic}.restricted-doc blockquote>:first-child{margin-top:0}.restricted-doc blockquote>:last-child{margin-bottom:0}.restricted-doc-toc ul{margin:.6rem 0 0;padding:0;list-style:none}.restricted-doc-toc li{margin:.35rem 0;line-height:1.35}.restricted-doc-toc li[data-level=\"3\"]{padding-left:.75rem}.restricted-doc-toc li[data-level=\"4\"]{padding-left:1.5rem}.restricted-doc-toc a{color:var(--restricted-muted);text-decoration:none}.restricted-doc-toc a:hover{color:var(--restricted-link)}.restricted-doc-toc-title{font-weight:600}.restricted-doc-not-found{min-height:20rem;padding:4rem 0;text-align:center}.restricted-doc-not-found h1{font-size:3rem}@media (max-width: 768px){.restricted-doc>h1{font-size:1.85rem}.restricted-doc th,.restricted-doc td{min-width:6.5rem;padding:.65rem .75rem}.restricted-doc-code pre{padding:1rem}}"}],"page":{"pagePath":"api-reference/voice-cloning-clone","slug":"/api-reference/voice-cloning-clone","pageMetadata":{"title":"Voice Clone","description":"Use this API for rapid voice cloning.\nIf a cloned voice is not used within 7 days, the system will delete it.","openapi":"api-reference/speech/voice-cloning/api/openapi.json POST /v1/voice_clone","href":"/api-reference/voice-cloning-clone"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Use this API for rapid voice cloning.\\nIf a cloned voice is not used within 7 days, the system will delete it.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Voice Clone","description":"Use this API for rapid voice cloning.\nIf a cloned voice is not used within 7 days, the system will delete it.","openapi":"api-reference/speech/voice-cloning/api/openapi.json POST /v1/voice_clone","href":"/api-reference/voice-cloning-clone"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/minimax-cac98058/74cbedfd7ddc6a81/scripts/auto-token.js","/docs/_mintlify/custom/minimax-cac98058/08175b8daa74cd64/scripts/logo.js","/docs/_mintlify/custom/minimax-cac98058/bdfa294452778802/scripts/head-userinfo.js","/docs/_mintlify/custom/minimax-cac98058/ee26a6e83cc5ae7f/scripts/navbar-same-tab.js","/docs/_mintlify/custom/minimax-cac98058/b2a91de372d716f8/scripts/pricing-dropdown.js","/docs/_mintlify/custom/minimax-cac98058/c76999ca41eb4aec/scripts/domain-link-rewrite.js","/docs/_mintlify/custom/minimax-cac98058/12fca2eba4fcc970/scripts/cookie-consent.js","/docs/_mintlify/custom/minimax-cac98058/444224329a77c4b1/scripts/page-view-tracking.js","/docs/_mintlify/custom/minimax-cac98058/07d15e8ada8d8bbf/scripts/restricted-docs-core.js","/docs/_mintlify/custom/minimax-cac98058/409396746d530a03/scripts/restricted-docs-highlight.js","/docs/_mintlify/custom/minimax-cac98058/728362c2608a54be/scripts/restricted-docs.js","/docs/_mintlify/custom/minimax-cac98058/50d87c5c4c9a98b0/scripts/rum.js","/docs/_mintlify/custom/minimax-cac98058/d479ebcf1e03e32e/scripts/pricing-navigation.js","/docs/_mintlify/custom/minimax-cac98058/b067abec70d0dbb6/scripts/feedback-consent.js"],"openApiReferenceData":{"operation":{"summary":"Voice Clone","operationId":"voiceClone","tags":["Voice"],"parameters":["9e68decd-47b8-43c8-ab0d-1d1e67b30522"],"requestBody":"6ca44afa-7efa-418c-81ca-bfc2be805020","responses":{"200":"0325df24-66d8-4bdc-8973-b244e7db0f74"},"method":"post","type":"path","servers":["c04a373a-cbd2-44c3-8ac7-5dbc8dada894"],"security":["4afbd848-d619-4600-9f42-2d741f7d8793"],"path":"/v1/voice_clone","baseUrlOptions":["https://api.minimax.io"],"title":"Voice Clone","description":"Use this API for rapid voice cloning.\nIf a cloned voice is not used within 7 days, the system will delete it.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.file_id":123456789,"body.voice_id":"\u003cvoice_id>","body.clone_prompt.prompt_audio":987654321,"body.clone_prompt.prompt_text":"This voice sounds natural and pleasant.","body.text":"A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.","body.model":"speech-2.8-hd","body.text_validation":"This voice sounds natural and pleasant.","body.accuracy":0.7,"body.need_noise_reduction":false,"body.need_volume_normalization":false,"body.aigc_watermark":false}]},"dependencies":{"parameters":{"9e68decd-47b8-43c8-ab0d-1d1e67b30522":{"name":"Content-Type","in":"header","required":true,"description":"The media type of the request body. Must be set to `application/json` to ensure the data is sent in JSON format.","schema":{"type":"string","enum":["application/json"],"default":"application/json","isRequired":true,"description":"The media type of the request body. Must be set to `application/json` to ensure the data is sent in JSON format.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"requestBody":{"description":"Voice clone request parameters","content":{"application/json":{"schema":{"type":"object","required":["file_id","voice_id"],"properties":{"file_id":{"type":"integer","format":"int64","description":"The `file_id` of the audio to be cloned, obtained through the [File Upload API](/api-reference/file-management-upload).\n\nUploaded files must comply with the following rules:\n- Accepted audio formats: mp3, m4a, wav\n- Audio duration: at least 10 seconds, no longer than 5 minutes\n- File size: no larger than 20 MB\n- If this parameter is used, both child attributes (prompt_audio, prompt_text) are required","isRequired":true,"uniqueKey":"file_id","typeLabel":"integer\u003cint64>"},"voice_id":{"type":"string","description":"The `voice_id` of the cloned voice. Example: `\"MiniMax001\"`. When defining a custom `voice_id`, note the following rules:\n- Length range: [8, 256]\n- Must start with an English letter\n- Can contain letters, digits, `-`, and `_`\n- Cannot end with `-` or `_`\n- Must not duplicate an existing `voice_id`, otherwise an error will occur","isRequired":true,"uniqueKey":"voice_id","typeLabel":"string"},"clone_prompt":{"type":"object","properties":{"prompt_audio":{"type":"integer","format":"int64","description":"The `file_id` of the sample audio, obtained through the [File Upload API](/api-reference/file-management-upload). The sample audio must be less than 8 seconds.","uniqueKey":"clone_prompt.prompt_audio","typeLabel":"integer\u003cint64>"},"prompt_text":{"type":"string","description":"The transcript corresponding to the sample audio. It must match the audio content, and end with punctuation.","uniqueKey":"clone_prompt.prompt_text","typeLabel":"string"}},"description":"Voice cloning parameters. Providing this field helps improve the similarity and stability of synthesized voice. If used, you must also upload a short sample audio clip (less than 8s, supported formats: mp3, m4a, wav) along with its corresponding transcript.","uniqueKey":"clone_prompt","typeLabel":"object"},"text":{"type":"string","description":"Optional preview text, up to 1000 characters. The cloned voice will be used to read the text, and an audio preview link will be returned.\nNote: Preview requests are charged based on character count, consistent with T2A pricing.\n- **Interjection tags**: Only supported when using `speech-2.8-hd` or `speech-2.8-turbo` models. Supported interjections: `(laughs)`, `(chuckle)`, `(coughs)`, `(clear-throat)`, `(groans)`, `(breath)`, `(pant)`, `(inhale)`, `(exhale)`, `(gasps)`, `(sniffs)`, `(sighs)`, `(snorts)`, `(burps)`, `(lip-smacking)`, `(humming)`, `(hissing)`, `(emm)`, `(whistles)`, `(sneezes)`, `(crying)`, `(applause)`.","uniqueKey":"text","typeLabel":"string"},"model":{"type":"string","description":"Specifies which voice synthesis model to use for generating the preview audio. Required when the `text` field is provided.","enum":["speech-2.8-hd","speech-2.8-turbo","speech-2.6-hd","speech-2.6-turbo","speech-02-hd","speech-02-turbo","speech-01-hd","speech-01-turbo"],"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"language_boost":{"type":"string","description":"Controls whether recognition for specific minority languages and dialects is enhanced. Default is `null`. If the language type is unknown, set to `\"auto\"` and the model will automatically detect it.","enum":["Chinese","Chinese,Yue","English","Arabic","Russian","Spanish","French","Portuguese","German","Turkish","Dutch","Ukrainian","Vietnamese","Indonesian","Japanese","Italian","Korean","Thai","Polish","Romanian","Greek","Czech","Finnish","Hindi","Bulgarian","Danish","Hebrew","Malay","Persian","Slovak","Swedish","Croatian","Filipino","Hungarian","Norwegian","Slovenian","Catalan","Nynorsk","Tamil","Afrikaans","auto"],"uniqueKey":"language_boost","typeLabel":"enum\u003cstring>"},"text_validation":{"type":"string","description":"Optional. The expected transcript of the cloning sample audio (matching the content of `file_id` or `clone_prompt.prompt_audio`). When provided, the audio is sent to ASR and the recognized text is compared against `text_validation`. If the similarity is below `accuracy`, the request is rejected with status code `1043` (`The asr similarity check failed`). Maximum length: 200 characters.","maxLength":200,"uniqueKey":"text_validation","typeLabel":"string"},"accuracy":{"type":"number","format":"double","description":"Optional. Similarity threshold used by the ASR validation triggered by `text_validation`. Valid range: `[0, 1]`. When omitted or set to `0`, defaults to `0.7`.","minimum":0,"maximum":1,"default":0.7,"uniqueKey":"accuracy","typeLabel":"number\u003cdouble>"},"need_noise_reduction":{"type":"boolean","description":"Indicates whether to enable noise reduction.","default":false,"uniqueKey":"need_noise_reduction","typeLabel":"boolean"},"need_volume_normalization":{"type":"boolean","description":"Indicates whether to enable volume normalization.","default":false,"uniqueKey":"need_volume_normalization","typeLabel":"boolean"},"aigc_watermark":{"type":"boolean","description":"Indicates whether to append an AIGC watermark tone to the end of the synthesized preview audio.","default":false,"uniqueKey":"aigc_watermark","typeLabel":"boolean"}},"example":{"file_id":123456789,"voice_id":"\u003cvoice_id>","clone_prompt":{"prompt_audio":987654321,"prompt_text":"This voice sounds natural and pleasant."},"text":"A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.","model":"speech-2.8-hd","text_validation":"This voice sounds natural and pleasant.","accuracy":0.7,"need_noise_reduction":false,"need_volume_normalization":false,"aigc_watermark":false},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file_id":123456789,"voice_id":"\u003cvoice_id>","clone_prompt":{"prompt_audio":987654321,"prompt_text":"This voice sounds natural and pleasant."},"text":"A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.","model":"speech-2.8-hd","text_validation":"This voice sounds natural and pleasant.","accuracy":0.7,"need_noise_reduction":false,"need_volume_normalization":false,"aigc_watermark":false}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"0325df24-66d8-4bdc-8973-b244e7db0f74":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"input_sensitive":{"type":"object","description":"Content safety check result","properties":{"type":{"type":"integer","description":"The category of the content safety trigger, one of:\n- `0`: Normal\n- `1`: Severe violation\n- `2`: Pornographic\n- `3`: Advertisement\n- `4`: Prohibited content\n- `5`: Abusive language\n- `6`: Terror/violence\n- `7`: Other","uniqueKey":"input_sensitive.type","typeLabel":"integer"}},"uniqueKey":"input_sensitive","typeLabel":"object"},"demo_audio":{"type":"string","description":"If both text and model are provided, this field returns a URL to the preview audio. Otherwise, it will be empty.","uniqueKey":"demo_audio","typeLabel":"string"},"extra_info":{"type":"object","description":"Preview audio metadata and billing info. Returned only when `text` is provided (i.e. preview synthesis happened and was billed). Field shape is aligned with `/v1/t2a_v2`.","properties":{"audio_length":{"type":"integer","format":"int64","description":"Preview audio duration in milliseconds.","uniqueKey":"extra_info.audio_length","typeLabel":"integer\u003cint64>"},"audio_sample_rate":{"type":"integer","format":"int64","description":"Preview audio sample rate.","uniqueKey":"extra_info.audio_sample_rate","typeLabel":"integer\u003cint64>"},"audio_size":{"type":"integer","format":"int64","description":"Preview audio file size in bytes.","uniqueKey":"extra_info.audio_size","typeLabel":"integer\u003cint64>"},"bitrate":{"type":"integer","format":"int64","description":"Preview audio bitrate.","uniqueKey":"extra_info.bitrate","typeLabel":"integer\u003cint64>"},"word_count":{"type":"integer","format":"int64","description":"Word count of spoken content (includes Chinese characters, digits, letters; excludes punctuation).","uniqueKey":"extra_info.word_count","typeLabel":"integer\u003cint64>"},"usage_characters":{"type":"integer","format":"int64","description":"Number of billable characters consumed by the preview synthesis. Use this for reconciliation against your account billing.","uniqueKey":"extra_info.usage_characters","typeLabel":"integer\u003cint64>"}},"uniqueKey":"extra_info","typeLabel":"object"},"base_resp":{"type":"object","required":["status_code"],"properties":{"status_code":{"type":"integer","format":"int64","description":"Status code.\n\n- 0: Success\n- 1000: Unknown error\n- 1001: Timeout\n- 1002: Rate limit triggered\n- 1004: Authentication failed\n- 1013: Internal service error\n- 2013: Invalid input format\n- 2038: No cloning permission, please check account verification status\n\nFor more information, please refer to the [Error Code Reference](/api-reference/errorcode).","isRequired":true,"uniqueKey":"base_resp.status_code","typeLabel":"integer\u003cint64>"},"status_msg":{"type":"string","description":"The status message","uniqueKey":"base_resp.status_msg","typeLabel":"string"}},"uniqueKey":"base_resp","typeLabel":"object"}},"example":{"input_sensitive":false,"input_sensitive_type":0,"demo_audio":"","extra_info":{"audio_length":11124,"audio_sample_rate":32000,"audio_size":179926,"bitrate":128000,"word_count":18,"usage_characters":18},"base_resp":{"status_code":0,"status_msg":"success"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"input_sensitive":false,"input_sensitive_type":0,"demo_audio":"","extra_info":{"audio_length":11124,"audio_sample_rate":32000,"audio_size":179926,"bitrate":128000,"word_count":18,"usage_characters":18},"base_resp":{"status_code":0,"status_msg":"success"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4afbd848-d619-4600-9f42-2d741f7d8793":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"`HTTP: Bearer Auth`\n- Security Scheme Type: http\n- HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account Management>API Keys](https://platform.minimax.io/user-center/basic-information/interface-key).","scopes":[]}}},"servers":{"c04a373a-cbd2-44c3-8ac7-5dbc8dada894":{"url":"https://api.minimax.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"`HTTP: Bearer Auth`\n- Security Scheme Type: http\n- HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account Management>API Keys](https://platform.minimax.io/user-center/basic-information/interface-key).","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"`HTTP: Bearer Auth`\n- Security Scheme Type: http\n- HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account Management>API Keys](https://platform.minimax.io/user-center/basic-information/interface-key).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/speech/voice-cloning/api/openapi.json"},"subdomain":"minimax-cac98058","siteName":"MiniMax API Docs","title":"Voice Clone - MiniMax API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-03T03:24:36.758Z","originalFileLocation":"api-reference/voice-cloning-clone.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Use this API for rapid voice cloning. If a cloned voice is not used within 7 days, the system will delete it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MiniMax API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Voice Clone - MiniMax API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use this API for rapid voice cloning. If a cloned voice is not used within 7 days, the system will delete it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MiniMax API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://minimax-cac98058.mintlify.app/_mintlify/api/og/v2?division=Voice+Cloning\u0026amp;title=Voice+Clone\u0026amp;description=Use+this+API+for+rapid+voice+cloning.%0AIf+a+cloned+voice+is+not+used+within+7+days%2C+the+system+will+delete+it.\u0026amp;theme=cd0e82347de717413e6212bc\u0026amp;signature=b5932737ff322f4160b6b909f4ebba6d66b674ef5f50d10fb8074c5e60647f1f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Voice Clone - MiniMax API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use this API for rapid voice cloning. If a cloned voice is not used within 7 days, the system will delete it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://minimax-cac98058.mintlify.app/_mintlify/api/og/v2?division=Voice+Cloning\u0026amp;title=Voice+Clone\u0026amp;description=Use+this+API+for+rapid+voice+cloning.%0AIf+a+cloned+voice+is+not+used+within+7+days%2C+the+system+will+delete+it.\u0026amp;theme=cd0e82347de717413e6212bc\u0026amp;signature=b5932737ff322f4160b6b909f4ebba6d66b674ef5f50d10fb8074c5e60647f1f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MiniMax API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#181E25\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/voice-cloning-clone.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://platform.minimax.io/#organization\",\"name\":\"MiniMax API Docs\",\"url\":\"https://platform.minimax.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/minimax-cac98058/XYzsL2L2ynonu2Q_/logo/light.svg?fit=max\u0026auto=format\u0026n=XYzsL2L2ynonu2Q_\u0026q=85\u0026s=9c99bb2678d62388d8a4e7cce1750858\"}},{\"@type\":\"WebSite\",\"@id\":\"https://platform.minimax.io/docs#website\",\"name\":\"MiniMax API Docs\",\"url\":\"https://platform.minimax.io/docs\",\"publisher\":{\"@id\":\"https://platform.minimax.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone#webpage\",\"url\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone\",\"name\":\"Voice Clone\",\"description\":\"Use this API for rapid voice cloning. If a cloned voice is not used within 7 days, the system will delete it.\",\"dateModified\":\"2026-02-03T03:24:36.758Z\",\"isPartOf\":{\"@id\":\"https://platform.minimax.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Speech\",\"item\":\"https://platform.minimax.io/docs/api-reference/speech-to-text\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Voice Cloning\",\"item\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-uploadcloneaudio\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Voice Clone\",\"item\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone#apireference\",\"headline\":\"Voice Clone\",\"name\":\"Voice Clone\",\"description\":\"Use this API for rapid voice cloning. If a cloned voice is not used within 7 days, the system will delete it.\",\"url\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone\",\"mainEntityOfPage\":{\"@id\":\"https://platform.minimax.io/docs/api-reference/voice-cloning-clone#webpage\"},\"dateModified\":\"2026-02-03T03:24:36.758Z\",\"publisher\":{\"@id\":\"https://platform.minimax.io/#organization\"},\"isPartOf\":{\"@id\":\"https://platform.minimax.io/docs#website\"}}]}\u003c/script>","siteName":"MiniMax API Docs","nav":{"global":null,"tabs":[{"tab":"Developer Guides","pages":[{"title":"Developer Guides","href":"/guides/models-intro"}]},{"tab":"API","groups":[{"group":"Using the API","pages":[{"title":"API Overview","sidebarTitle":"API Overview","href":"/api-reference/api-overview"},{"title":"Rate Limits","href":"/guides/rate-limits"},{"title":"Error Codes","sidebarTitle":"Error Code Reference","href":"/api-reference/errorcode"}]},{"group":"Text","icon":"https://filecdn.minimax.chat/public/4ab63cda-da2a-4c77-b1c7-900d2562073f.png","pages":[{"title":"Anthropic SDK","sidebarTitle":"Anthropic SDK (Recommended)","href":"/api-reference/text-anthropic-api"},{"title":"OpenAI SDK","sidebarTitle":"OpenAI SDK","href":"/api-reference/text-openai-api"},{"title":"AI SDK","sidebarTitle":"AI SDK","href":"/api-reference/text-ai-sdk"},{"group":"Anthropic Messages API","pages":[{"title":"Create Message","sidebarTitle":"Create Message","openapi":"api-reference/text/api/openapi-chat-anthropic.json POST /anthropic/v1/messages","href":"/api-reference/text-chat-anthropic"}]},{"group":"OpenAI Chat Completions API","pages":[{"title":"Create Chat Completion","sidebarTitle":"Create Chat Completion","openapi":"api-reference/text/api/openapi-chat-openai.json POST /v1/chat/completions","href":"/api-reference/text-chat-openai"}]},{"group":"OpenAI Responses API","pages":[{"title":"Create Response","sidebarTitle":"Create Response","openapi":"api-reference/text/api/openapi-responses.json POST /v1/responses","href":"/api-reference/responses-create"},{"title":"Estimate Input Tokens","sidebarTitle":"Estimate Input Tokens","openapi":"api-reference/text/api/openapi-responses.json POST /v1/responses/input_tokens","href":"/api-reference/responses-input-tokens"}]}]},{"group":"Video","icon":"https://filecdn.minimax.chat/public/766ab356-4817-4bf1-8849-0f64728d811f.png","pages":[{"group":"MiniMax-H3","tag":"NEW","pages":[{"title":"Create Video Generation Task","sidebarTitle":"Create Video Generation Task","openapi":"api-reference/video/generation/api/v2-video-generation.json POST /v2/video_generation","href":"/api-reference/video-generation-v2-create"},{"title":"Query Task","sidebarTitle":"Query Task","openapi":"api-reference/video/generation/api/v2-video-generation.json GET /v2/query/video_generation/{task_id}","href":"/api-reference/video-generation-v2-query"},{"title":"List Tasks","sidebarTitle":"List Tasks","openapi":"api-reference/video/generation/api/v2-video-generation.json GET /v2/query/video_generation","href":"/api-reference/video-generation-v2-list"},{"title":"Cancel or Delete Task","sidebarTitle":"Cancel or Delete Task","openapi":"api-reference/video/generation/api/v2-video-generation.json DELETE /v2/video_generation/{task_id}","href":"/api-reference/video-generation-v2-delete"},{"title":"Create H3-Context-IR Task","sidebarTitle":"Create H3-Context-IR Task","openapi":"api-reference/video/generation/api/v2-video-generation.json POST /v2/h3_context_ir","href":"/api-reference/video-generation-v2-h3-context-ir"},{"title":"Create Video Regeneration Task","sidebarTitle":"Create Video Regeneration Task","openapi":"api-reference/video/generation/api/v2-video-generation.json POST /v2/video_regeneration","href":"/api-reference/video-generation-v2-regeneration"}]},{"group":"Video Generation","pages":[{"title":"Create Text-to-Video Generation Task","sidebarTitle":"Text to Video","openapi":"api-reference/video/generation/api/text-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-t2v"},{"title":"Image-to-Video Task","sidebarTitle":"Image to Video","openapi":"api-reference/video/generation/api/image-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-i2v"},{"title":"Create First \u0026 Last Frame Video Generation Task","sidebarTitle":"Start / End to Video","openapi":"api-reference/video/generation/api/start-end-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-fl2v"},{"title":"Subject-Reference to Video Generation Task","sidebarTitle":"Subject Reference to Video","openapi":"api-reference/video/generation/api/subject-reference-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-s2v"},{"title":"Query Video Generation Task Status","openapi":"api-reference/video/generation/api/openapi.json GET /v1/query/video_generation","href":"/api-reference/video-generation-query"},{"title":"Video Download","sidebarTitle":"Download the Video File","openapi":"api-reference/video/generation/api/openapi.json GET /v1/files/retrieve","href":"/api-reference/video-generation-download"}]}]},{"group":"Speech","icon":"https://filecdn.minimax.chat/public/ebfd6f8e-5b5a-4edd-8253-6c731d3b368f.png","pages":[{"group":"Speech to Text","tag":"NEW","pages":[{"title":"Speech to Text","sidebarTitle":"Speech to Text","openapi":"api-reference/speech/speech-to-text/api/openapi.json POST /v1/speech_to_text","href":"/api-reference/speech-to-text"}]},{"group":"Text to Speech","pages":[{"title":"Synchronous Text to Speech","openapi":"api-reference/speech/t2a/api/openapi.json POST /v1/t2a_v2","href":"/api-reference/speech-t2a-http"},{"title":"Synchronous Text to Speech","asyncapi":"api-reference/speech/t2a/api/asyncapi.json t2a_v2_websocket","href":"/api-reference/speech-t2a-websocket"},{"title":"Bidirectional Streaming Text to Speech","asyncapi":"api-reference/speech/t2a/api/asyncapi-bidi.json t2a_v2_bidi_websocket","href":"/api-reference/speech-t2a-websocket-bidi"}]},{"group":"Async Text to Speech","pages":[{"title":"Create Speech Generation Task","openapi":"api-reference/speech/t2a-async/api/openapi.json POST /v1/t2a_async_v2","href":"/api-reference/speech-t2a-async-create"},{"title":"Query Speech Generation Task Status","openapi":"api-reference/speech/t2a-async/api/openapi.json GET /v1/query/t2a_async_query_v2","href":"/api-reference/speech-t2a-async-query"}]},{"group":"Voice Cloning","pages":[{"title":"Upload Audio for Voice Cloning","sidebarTitle":"Upload Audio File","openapi":"api-reference/speech/voice-cloning/api/upload-file.json POST /v1/files/upload","href":"/api-reference/voice-cloning-uploadcloneaudio"},{"title":"Upload Prompt Audio","sidebarTitle":"Upload Prompt Audio","description":"Use this API to upload prompt audio file. Providing this file helps to enhance the voice similarity and stability of the Text-to-Speech output.","openapi":"api-reference/speech/voice-cloning/api/upload-prompt.json POST /v1/files/upload","href":"/api-reference/voice-cloning-uploadprompt"},{"title":"Voice Clone","openapi":"api-reference/speech/voice-cloning/api/openapi.json POST /v1/voice_clone","href":"/api-reference/voice-cloning-clone"}]},{"group":"Voice Design","pages":[{"title":"Voice Design","description":"Use this API to design custom voices by inputting text.","openapi":"api-reference/speech/voice-design/api/openapi.json POST /v1/voice_design","href":"/api-reference/voice-design-design"}]},{"group":"Voice Management","pages":[{"title":"Get Voice","openapi":"api-reference/speech/voice-management/api/openapi.json POST /v1/get_voice","href":"/api-reference/voice-management-get"},{"title":"Delete Voice","openapi":"api-reference/speech/voice-management/api/openapi.json POST /v1/delete_voice","href":"/api-reference/voice-management-delete"}]}]},{"group":"Image","icon":"https://filecdn.minimax.chat/public/c67ded66-6213-441f-b784-6866c6943aef.png","pages":[{"group":"Image Generation","pages":[{"title":"Text to Image Generation","sidebarTitle":"Text-to-Image","openapi":"api-reference/image/generation/api/text-to-image.json POST /v1/image_generation","href":"/api-reference/image-generation-t2i"},{"title":"Image-to-Image Generation","sidebarTitle":"Image to Image","openapi":"api-reference/image/generation/api/image-to-image.json POST /v1/image_generation","href":"/api-reference/image-generation-i2i"}]}]},{"group":"File","icon":"https://filecdn.minimax.chat/public/1291e3fd-3307-4344-ba3e-40fa3780419f.png","pages":[{"group":"File Management","pages":[{"title":"Upload File","sidebarTitle":"Upload","openapi":"api-reference/file/management/api/openapi.json POST /v1/files/upload","href":"/api-reference/file-management-upload"},{"title":"List Files","sidebarTitle":"List","openapi":"api-reference/file/management/api/openapi.json GET /v1/files/list","href":"/api-reference/file-management-list"},{"title":"Retrieve File","sidebarTitle":"Retrieve","openapi":"api-reference/file/management/api/openapi.json GET /v1/files/retrieve","href":"/api-reference/file-management-retrieve"},{"title":"Retrieve Content","sidebarTitle":"Retrieve File Content","openapi":"api-reference/file/management/api/openapi.json GET /v1/files/retrieve_content","href":"/api-reference/file-management-retrieve-content"},{"title":"Delete File","sidebarTitle":"Delete","openapi":"api-reference/file/management/api/openapi.json POST /v1/files/delete","href":"/api-reference/file-management-delete"}]}]},{"group":"Models","icon":"boxes","pages":[{"group":"OpenAI Compatible","pages":[{"title":"List Models","openapi":"api-reference/models/openai/api/list-models.json GET /v1/models","href":"/api-reference/models/openai/list-models"},{"title":"Retrieve Model","openapi":"api-reference/models/openai/api/retrieve-model.json GET /v1/models/{model_id}","href":"/api-reference/models/openai/retrieve-model"}]},{"group":"Anthropic Compatible","pages":[{"title":"List Models","openapi":"api-reference/models/anthropic/api/list-models.json GET /anthropic/v1/models","href":"/api-reference/models/anthropic/list-models"},{"title":"Retrieve Model","openapi":"api-reference/models/anthropic/api/retrieve-model.json GET /anthropic/v1/models/{model_id}","href":"/api-reference/models/anthropic/retrieve-model"}]}]}]},{"tab":"M Plan","pages":[{"title":"M Plan","href":"/m-plan/intro"}]},{"tab":"Pricing","pages":[{"title":"Pricing","href":"/pricing/overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/models"}]},{"tab":"Developer Program","href":"https://platform.minimax.io/activity/contact-us-en"}]},"basePath":"","title":"Voice Clone - MiniMax API Docs","buildId":"dpl_9yaRmq8qi7yyMZn9oEWmKEdYMvGZ","deploymentId":"dpl_9yaRmq8qi7yyMZn9oEWmKEdYMvGZ","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-Cid2x0Kq.js","dist-CpdUkuDP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-BZ8NiN2w.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-Bsljvftq.js","utils-BEZX0tmN.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BrDD79Na.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-2c3Nf5XI.js","snippetPresets-CWWkg29k.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-SJmWKHmz.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BYc8UL58.js","shallow-UTXCq4wY.js","getApiPlaygroundDisplay-D1ZcrmBl.js","CodeSnippet-CTS7L7R4.js","CodeSnippets-MsBYl-gd.js","Page-BxumJvVQ.js","getPastedJson-C_5Mq0uv.js","icon-D7sYgD4k.js","MethodPill-B7Q6uD_j.js","DuplicateIcon-DXGzB8u_.js","createIcon-UDYg_Gk8.js","DynamicMarkdown-BBrVIqs3.js","SectionHeading-BxanXFN4.js","axios-vUo_bRtp.js","Markdown-DAhL0GAo.js","AssistantPageLink-sMo3-CxC.js"]}