Responses are generated using AI and may contain mistakes.
Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to support@bland.ai with questions.
{ "status": 400, "data": null, "errors": [ { "error": "Validation Error", "message": "No files provided for voice cloning." } ]}
{ "status": 400, "data": null, "errors": [ { "error": "Limit Exceeded", "message": "You have reached the maximum number of voices for your plan." } ]}
Overview
Creates a Bland TTS voice clone from one or more audio samples. Sent as multipart/form-data. The new voice is private to your org and immediately usable with Speak.Two cloning engines are available, selectable per request:
BTTS V3 (default), single 10-second sample, 17+ languages, highest fidelity. Returned service: "BTTS_V3".
{ "status": 400, "data": null, "errors": [ { "error": "Validation Error", "message": "No files provided for voice cloning." } ]}
{ "status": 400, "data": null, "errors": [ { "error": "Limit Exceeded", "message": "You have reached the maximum number of voices for your plan." } ]}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Bland","colors":{"primary":"#CA071A","light":"#FFFDF6","dark":"#151515"},"logo":{"light":"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/light.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=c9e5f30d1a8880ad00ef715c1ffa2215","dark":"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/dark.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=be3890a932c8cd55b89ac9df2d018955"},"favicon":"https://mintcdn.com/blandai/7XcPgtv7sOmwQOkQ/favicon.png?fit=max\u0026auto=format\u0026n=7XcPgtv7sOmwQOkQ\u0026q=85\u0026s=03a241cc1c1162995574df4a2166b331","background":{"color":{"light":"#FFFDF5","dark":"#151515"}},"navbar":{"links":[{"href":"https://app.bland.ai/dashboard/support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.bland.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/usebland","linkedin":"https://www.linkedin.com/company/bland-ai","discord":"https://discord.gg/QvxDz8zcKe"}},"seo":{"indexing":"all"},"banner":{"content":"Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to [support@bland.ai](mailto:support@bland.ai) with questions.","dismissible":true},"contextual":{"options":["copy","view","claude","chatgpt","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/QvxDz8zcKe"},{"anchor":"Submit a support ticket","icon":"ticket","href":"https://app.bland.ai/dashboard/support"},{"anchor":"Blog","icon":"newspaper","href":"https://www.bland.ai/blog"},{"anchor":"Enterprise inquiries","icon":"building","href":"https://www.bland.ai/book-a-demo"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blandai","hasAudioNarration":false,"actualSubdomain":"blandai","customDomains":["docs.bland.ai"],"gitSource":{"type":"github","owner":"cintellilabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afdf11461865a2329ebf38b","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":519},{"language":"default","tag":"API Reference","count":421},{"language":"default","tag":"Legacy","count":104},{"language":"default","tag":"Documentation","count":98},{"language":"default","tag":"Changelog","count":50},{"language":"default","tag":"Change Log","count":50},{"language":"default","tag":"TTS","count":42},{"language":"default","tag":"Evals","count":36},{"language":"default","tag":"Dispositions","count":31},{"language":"default","tag":"Triage","count":26}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600\u0026display=swap');.card h2+.prose{margin-top:0.75rem}#content-area #header .mt-2 p{font-size:1rem}:root{--splash-font-display: ui-sans-serif, -apple-system, \"Segoe UI\", system-ui, sans-serif;--splash-font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace}.splash-display{font-family:var(--splash-font-display)}.splash-mono{font-family:var(--splash-font-mono)}@keyframes splash-settle{from{opacity:0;transform:scale(0.86)}to{opacity:1;transform:none}}@keyframes splash-breathe{0%,38%{opacity:1}50%,76%{opacity:0}88%,100%{opacity:1}}@media (prefers-reduced-motion: no-preference){.splash-settle{animation:splash-settle 380ms cubic-bezier(0.22, 0.61, 0.36, 1) both;transform-origin:center}.splash-breathe{animation:splash-breathe var(--splash-breathe-dur, 19s) ease-in-out infinite;animation-delay:var(--splash-breathe-delay, 0s)}.splash-cell{transition:transform 240ms cubic-bezier(0.22, 0.61, 0.36, 1)}.splash-cell:hover{transform:scale(1.09);z-index:1}}.splash-frame-a,.splash-diffuse{display:none}.splash-ballast-inset{padding-left:1.5rem;padding-right:1.5rem}.splash-ballast-herotext{padding-top:4rem;padding-bottom:3.5rem}@media (max-width: 1023px){.splash-ballast-herotext{padding-top:calc(4rem + 96px)}}.splash-ballast-h1{font-size:40px;line-height:1.06}@media (min-width: 1152px){.splash-display{--splash-module: clamp(48px, calc((100vw - 1472px) / 12 + 6px), 72px)}.splash-frame-a{display:grid;grid-template-columns:repeat(72, var(--splash-module));grid-template-rows:repeat(8, var(--splash-module))}.splash-diffuse{display:none;grid-template-columns:repeat(72, var(--splash-module));grid-auto-rows:var(--splash-module)}.splash-ballast-inset{padding-left:max(calc(var(--splash-module) * 6), calc((100% - 1472px) / 2 + 48px));padding-right:max(1.5rem, calc((100% - 1472px) / 2 + 48px))}.splash-ballast-hero{height:calc(var(--splash-module) * 3.94 + 322px)}.splash-ballast-herotext{padding-top:calc(var(--splash-module) * 3.94);padding-bottom:0}.splash-ballast-h1{font-size:58px;line-height:62px}}body:has(.splash-display) header .backdrop-blur{backdrop-filter:none;-webkit-backdrop-filter:none}#sidebar-content{background:#FFFDF5;border-right:1px solid #1515150f;width:var(--sidebar-w)}:root{--sidebar-w: 248px}@media (min-width: 1024px){#body-content{padding-left:var(--sidebar-w)}}:root[class~=\"dark\"] #sidebar-content,.dark #sidebar-content{background:#0f0f0f;border-right-color:#ffffff12}#navigation-items{padding-left:1.25rem;padding-right:1rem;padding-top:1.5rem}#sidebar-content a{font-size:13.5px;line-height:1.35;padding-top:5px;padding-bottom:5px}#navigation-items{padding-left:0.75rem}#navigation-items [class*=\"scroll-area-fade-size\"]{padding-left:0;padding-right:0}#sidebar-content h5,#sidebar-content [class*=\"font-semibold\"]:not(a){font-size:11px;letter-spacing:0.06em;text-transform:uppercase;opacity:0.55;margin-top:1.5rem;margin-bottom:0.35rem}#navigation-items{scrollbar-width:thin;scrollbar-color:transparent transparent}#navigation-items:hover{scrollbar-color:#15151526 transparent}@media (min-width: 1024px){.splash-display{--splash-module: clamp(30px, calc((100vw - var(--sidebar-w) - 96px) / 26), 72px)}.splash-ballast-inset{padding-left:3rem;padding-right:3rem}.splash-ballast-inset.splash-ballast-herotext{padding-left:calc(var(--splash-module) * 6)}}@media (min-width: 1024px){.splash-ballast-inset [class*=\"grid-cols\"]{max-width:1180px}}@media (min-width: 1600px){.splash-display{--splash-module: clamp(30px, min(\n calc((100vw - var(--sidebar-w) - 96px) / 26),\n calc((100vw - 1540px) / 10)\n ), 72px)}.splash-ballast-inset{max-width:1276px;margin-inline:auto}.splash-ballast-inset.splash-ballast-herotext{padding-left:48px}}@media (min-width: 1024px){.splash-display{--splash-rule-gap: 64px}.splash-ballast-hero{height:auto}.splash-ballast-inset.splash-ballast-herotext{padding-bottom:var(--splash-rule-gap)}.splash-ballast-inset[class*=\"py-12\"]{padding-top:var(--splash-rule-gap)}}"}],"page":{"pagePath":"api-v1/post/clone","slug":"/api-v1/post/clone","pageMetadata":{"title":"Clone Voice","api":"POST https://api.bland.ai/v1/voices/clone","description":"Create a custom voice clone from audio samples.","contentType":"multipart/form-data","href":"/api-v1/post/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: \"Create a custom voice clone from audio samples.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Heading,ParamField,ResponseField}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Creates a Bland TTS voice clone from one or more audio samples. Sent as `,_jsx(_components.code,{children:`multipart/form-data`}),`. The new voice is private to your org and immediately usable with `,_jsx(_components.a,{href:`/api-v2/post/tts`,children:`Speak`}),`.`]}),`\n`,_jsx(_components.p,{children:`Two cloning engines are available, selectable per request:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`BTTS V3`}),` (default), single 10-second sample, 17+ languages, highest fidelity. Returned `,_jsx(_components.code,{children:`service: \"BTTS_V3\"`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`BTTS V2`}),`, exactly 1 WAV file, 17+ languages. Returned `,_jsx(_components.code,{children:`service: \"BTTS_V2\"`}),`.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`form-fields`,children:`Form Fields`}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Display name for the voice clone. 1-30 characters. Must be unique in your library.`})}),`\n`,_jsx(ParamField,{body:`audio_samples`,type:`file[]`,required:true,id:`param-audio-samples`,children:_jsx(_components.p,{children:`Audio file or files. Constraints depend on the engine flag (see below). WAV format recommended.`})}),`\n`,_jsx(ParamField,{body:`gender`,type:`string`,id:`param-gender`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`male`}),` or `,_jsx(_components.code,{children:`female`}),`. Optional but recommended; helps the underlying model.`]})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Free-text description. Surfaced as additional context to the model for tone and style.`})}),`\n`,_jsx(ParamField,{body:`isBTTS_V3`,type:`boolean`,id:`param-is-btts-v3`,children:_jsxs(_components.p,{children:[`Use the V3 engine. Default if no engine flag is set. Pass `,_jsx(_components.code,{children:`\"true\"`}),` as a multipart string.`]})}),`\n`,_jsx(ParamField,{body:`isBTTS_V2`,type:`boolean`,id:`param-is-btts-v2`,children:_jsxs(_components.p,{children:[`Use the V2 engine instead of V3. Pass `,_jsx(_components.code,{children:`\"true\"`}),` as a multipart string.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`engine-constraints`,children:`Engine constraints`}),`\n`,_jsxs(_components.p,{children:[`Each engine validates `,_jsx(_components.code,{children:`audio_samples`}),` differently. Mismatched files will return a `,_jsx(_components.code,{children:`Validation Error`}),` before the clone is created.`]}),`\n`,_jsx(Accordion,{title:`V3 (default)`,id:`v3-default`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Exactly 1 audio file.`}),`\n`,_jsx(_components.li,{children:`Roughly 10 seconds is ideal.`}),`\n`,_jsx(_components.li,{children:`Max 10 MB.`}),`\n`,_jsx(_components.li,{children:`17+ languages supported.`}),`\n`]})}),`\n`,_jsx(Accordion,{title:`V2 (isBTTS_V2=true)`,id:`v2-isbtts-v2-true`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Exactly 1 audio file.`}),`\n`,_jsx(_components.li,{children:`Roughly 10 seconds is ideal.`}),`\n`,_jsx(_components.li,{children:`Max 10 MB.`}),`\n`,_jsx(_components.li,{children:`17+ languages supported.`}),`\n`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`200 OK`}),` with the new voice on success.`]}),`\n`,_jsx(ResponseField,{name:`data.voice_id`,type:`string`,id:`param-data-voice-id`,children:_jsxs(_components.p,{children:[`UUID of the new voice clone. Use it as `,_jsx(_components.code,{children:`voice_id`}),` in `,_jsx(_components.a,{href:`/api-v2/post/tts`,children:`Speak`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`data.name`,type:`string`,id:`param-data-name`,children:_jsx(_components.p,{children:`The display name you provided.`})}),`\n`,_jsx(ResponseField,{name:`errors`,type:`null | array`,id:`param-errors`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`null`}),` on success.`]})}),`\n`,`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`V2 and V3 voices are single-sample by design. Use `,_jsx(_components.a,{href:`/api-v1/get/voices-id-samples`,children:`List Voice Samples`}),` to inspect the source sample attached to a voice.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`Docs for agents: `,_jsx(_components.a,{href:`/llms.txt`,children:`llms.txt`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Clone Voice","api":"POST https://api.bland.ai/v1/voices/clone","description":"Create a custom voice clone from audio samples.","contentType":"multipart/form-data","href":"/api-v1/post/clone"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Heading,ParamField,ResponseExample,ResponseField}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Creates a Bland TTS voice clone from one or more audio samples. Sent as `,_jsx(_components.code,{children:`multipart/form-data`}),`. The new voice is private to your org and immediately usable with `,_jsx(_components.a,{href:`/api-v2/post/tts`,children:`Speak`}),`.`]}),`\n`,_jsx(_components.p,{children:`Two cloning engines are available, selectable per request:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`BTTS V3`}),` (default), single 10-second sample, 17+ languages, highest fidelity. Returned `,_jsx(_components.code,{children:`service: \"BTTS_V3\"`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`BTTS V2`}),`, exactly 1 WAV file, 17+ languages. Returned `,_jsx(_components.code,{children:`service: \"BTTS_V2\"`}),`.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`form-fields`,children:`Form Fields`}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Display name for the voice clone. 1-30 characters. Must be unique in your library.`})}),`\n`,_jsx(ParamField,{body:`audio_samples`,type:`file[]`,required:true,id:`param-audio-samples`,children:_jsx(_components.p,{children:`Audio file or files. Constraints depend on the engine flag (see below). WAV format recommended.`})}),`\n`,_jsx(ParamField,{body:`gender`,type:`string`,id:`param-gender`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`male`}),` or `,_jsx(_components.code,{children:`female`}),`. Optional but recommended; helps the underlying model.`]})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Free-text description. Surfaced as additional context to the model for tone and style.`})}),`\n`,_jsx(ParamField,{body:`isBTTS_V3`,type:`boolean`,id:`param-is-btts-v3`,children:_jsxs(_components.p,{children:[`Use the V3 engine. Default if no engine flag is set. Pass `,_jsx(_components.code,{children:`\"true\"`}),` as a multipart string.`]})}),`\n`,_jsx(ParamField,{body:`isBTTS_V2`,type:`boolean`,id:`param-is-btts-v2`,children:_jsxs(_components.p,{children:[`Use the V2 engine instead of V3. Pass `,_jsx(_components.code,{children:`\"true\"`}),` as a multipart string.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`engine-constraints`,children:`Engine constraints`}),`\n`,_jsxs(_components.p,{children:[`Each engine validates `,_jsx(_components.code,{children:`audio_samples`}),` differently. Mismatched files will return a `,_jsx(_components.code,{children:`Validation Error`}),` before the clone is created.`]}),`\n`,_jsx(Accordion,{title:`V3 (default)`,id:`v3-default`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Exactly 1 audio file.`}),`\n`,_jsx(_components.li,{children:`Roughly 10 seconds is ideal.`}),`\n`,_jsx(_components.li,{children:`Max 10 MB.`}),`\n`,_jsx(_components.li,{children:`17+ languages supported.`}),`\n`]})}),`\n`,_jsx(Accordion,{title:`V2 (isBTTS_V2=true)`,id:`v2-isbtts-v2-true`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Exactly 1 audio file.`}),`\n`,_jsx(_components.li,{children:`Roughly 10 seconds is ideal.`}),`\n`,_jsx(_components.li,{children:`Max 10 MB.`}),`\n`,_jsx(_components.li,{children:`17+ languages supported.`}),`\n`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`200 OK`}),` with the new voice on success.`]}),`\n`,_jsx(ResponseField,{name:`data.voice_id`,type:`string`,id:`param-data-voice-id`,children:_jsxs(_components.p,{children:[`UUID of the new voice clone. Use it as `,_jsx(_components.code,{children:`voice_id`}),` in `,_jsx(_components.a,{href:`/api-v2/post/tts`,children:`Speak`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`data.name`,type:`string`,id:`param-data-name`,children:_jsx(_components.p,{children:`The display name you provided.`})}),`\n`,_jsx(ResponseField,{name:`errors`,type:`null | array`,id:`param-errors`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`null`}),` on success.`]})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`Response`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"voice_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"4cc89edf-c4b7-4df8-98c5-f8548fcd7c62\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DocTestClone\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Validation Error`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Validation Error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"No files provided for voice cloning.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Voice Limit Exceeded`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Limit Exceeded\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You have reached the maximum number of voices for your plan.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`V2 and V3 voices are single-sample by design. Use `,_jsx(_components.a,{href:`/api-v1/get/voices-id-samples`,children:`List Voice Samples`}),` to inspect the source sample attached to a voice.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`Docs for agents: `,_jsx(_components.a,{href:`/llms.txt`,children:`llms.txt`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Clone Voice","api":"POST https://api.bland.ai/v1/voices/clone","description":"Create a custom voice clone from audio samples.","contentType":"multipart/form-data","href":"/api-v1/post/clone"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Form Fields","slug":"form-fields","depth":2,"children":[]},{"title":"Engine constraints","slug":"engine-constraints","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">200\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"voice_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"4cc89edf-c4b7-4df8-98c5-f8548fcd7c62\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"DocTestClone\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Validation Error","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">400\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Validation Error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"No files provided for voice cloning.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Voice Limit Exceeded","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">400\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Limit Exceeded\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"You have reached the maximum number of voices for your plan.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Clone Voice","path":"/v1/voices/clone","servers":[{"url":"https://api.bland.ai"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"authorization":{"schema":[{"type":"string","description":"Your API key for authentication.","required":true}]}},"cookie":{},"path":{}},"body":{"multipart/form-data":{"schemaArray":[{"type":"object","properties":{"name":[{"type":"string","description":"Display name for the voice clone. 1-30 characters. Must be unique in your library.","required":true}],"audio_samples":[{"type":"array","items":[{"type":"file"}],"description":"Audio file or files. Constraints depend on the engine flag (see below). WAV format recommended.","required":true}],"gender":[{"type":"string","description":"`male` or `female` . Optional but recommended; helps the underlying model."}],"description":[{"type":"string","description":"Free-text description. Surfaced as additional context to the model for tone and style."}],"isBTTS_V3":[{"type":"boolean","description":"Use the V3 engine. Default if no engine flag is set. Pass `\"true\"` as a multipart string."}],"isBTTS_V2":[{"type":"boolean","description":"Use the V2 engine instead of V3. Pass `\"true\"` as a multipart string."}]}}],"examples":{"example":{"value":{"name":"\u003cstring>","audio_samples":[null],"gender":"\u003cstring>","description":"\u003cstring>","isBTTS_V3":true,"isBTTS_V2":true}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data.voice_id":[{"type":"string","description":"UUID of the new voice clone. Use it as `voice_id` in Speak ."}],"data.name":[{"type":"string","description":"The display name you provided."}],"errors":[{"type":"object","properties":{},"description":"`null` on success."}]}}],"examples":{"example":{"value":{"data.voice_id":"\u003cstring>","data.name":"\u003cstring>","errors":{}}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/blandai/02e9da7d1fa2fc47/script.js"],"subdomain":"blandai","siteName":"Bland","title":"Clone Voice - Bland","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-07T18:38:15.012Z","originalFileLocation":"api-v1/post/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=\"Create a custom voice clone from audio samples.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bland\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_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=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Clone Voice - Bland\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a custom voice clone from audio samples.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bland\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bland.ai/api-v1/post/clone\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Voice+Cloning\u0026amp;title=Clone+Voice\u0026amp;description=Create+a+custom+voice+clone+from+audio+samples.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=edffed2c31366b3accad5ca6ef898346b67cf2b67511cc16ad1d50bc90acaa1f\">\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=\"Clone Voice - Bland\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a custom voice clone from audio samples.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Voice+Cloning\u0026amp;title=Clone+Voice\u0026amp;description=Create+a+custom+voice+clone+from+audio+samples.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=edffed2c31366b3accad5ca6ef898346b67cf2b67511cc16ad1d50bc90acaa1f\">\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=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bland\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#CA071A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bland.ai/api-v1/post/clone\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v1/post/clone.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bland.ai/#organization\",\"name\":\"Bland\",\"url\":\"https://docs.bland.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/light.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=c9e5f30d1a8880ad00ef715c1ffa2215\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bland.ai#website\",\"name\":\"Bland\",\"url\":\"https://docs.bland.ai\",\"publisher\":{\"@id\":\"https://docs.bland.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bland.ai/api-v1/post/clone#webpage\",\"url\":\"https://docs.bland.ai/api-v1/post/clone\",\"name\":\"Clone Voice\",\"description\":\"Create a custom voice clone from audio samples.\",\"dateModified\":\"2026-08-07T18:38:15.012Z\",\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bland.ai/api-v1/post/clone#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bland.ai/api-v1/post/clone#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bland\",\"item\":\"https://docs.bland.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Clone Voice\",\"item\":\"https://docs.bland.ai/api-v1/post/clone\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bland.ai/api-v1/post/clone#apireference\",\"headline\":\"Clone Voice\",\"name\":\"Clone Voice\",\"description\":\"Create a custom voice clone from audio samples.\",\"url\":\"https://docs.bland.ai/api-v1/post/clone\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bland.ai/api-v1/post/clone#webpage\"},\"dateModified\":\"2026-08-07T18:38:15.012Z\",\"publisher\":{\"@id\":\"https://docs.bland.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bland\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bland\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-v1/post/clone.md","siteName":"Bland","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/QvxDz8zcKe"},{"anchor":"Submit a support ticket","icon":"ticket","href":"https://app.bland.ai/dashboard/support"},{"anchor":"Blog","icon":"newspaper","href":"https://www.bland.ai/blog"},{"anchor":"Enterprise inquiries","icon":"building","href":"https://www.bland.ai/book-a-demo"}]},"products":[{"product":"Voice Agents","pages":[{"title":"Voice Agents","href":"/build-your-first-agent"}]},{"product":"TTS","groups":[{"group":"Get Started","pages":[{"title":"Welcome to Bland Speech","href":"/tts/welcome"},{"title":"Speech Quickstart","href":"/tts/quickstart"},{"title":"Realtime TTS Quickstart","href":"/tts/realtime-quickstart"},{"title":"Realtime TTS Concepts","href":"/tts/realtime-concepts"},{"title":"Choosing a Voice","href":"/tts/voices"},{"title":"Writing for Speech","href":"/tts/writing-for-speech"},{"title":"Speech Studio","href":"/tts/speech-studio"},{"title":"Speech Limits","href":"/speech/limits"}]},{"group":"Realtime Speech","pages":[{"title":"Realtime Speech (WebSocket)","href":"/api-v2/post/tts-ws"}]},{"group":"HTTP Speech","pages":[{"title":"Synthesize Speech (HTTP)","api":"POST https://api.bland.ai/v2/tts","href":"/api-v2/post/tts"},{"title":"Speech (OpenAI-compatible)","api":"POST https://api.bland.ai/v2/audio/speech","href":"/api-v2/post/audio-speech"}]},{"group":"Migrate","pages":[{"title":"Migrate to Bland Speech","href":"/tts/migrate"},{"title":"Migrate from ElevenLabs","href":"/tts/migrations/elevenlabs"},{"title":"Migrate from Cartesia","href":"/tts/migrations/cartesia"},{"title":"Migrate from Deepgram","href":"/tts/migrations/deepgram"},{"title":"Migrate from PlayHT","href":"/tts/migrations/playht"},{"title":"Migrate from Resemble AI","href":"/tts/migrations/resemble"},{"title":"Migrate from Google Cloud TTS","href":"/tts/migrations/google-cloud"},{"title":"Migrate from Amazon Polly","description":"Move Amazon Polly synthesis to Bland HTTP or stream LLM tokens through Bland realtime TTS.","href":"/tts/migrations/amazon-polly"}]},{"group":"Voice Cloning","pages":[{"title":"Clone Voice","api":"POST https://api.bland.ai/v1/voices/clone","href":"/api-v1/post/clone"}]},{"group":"Voices","pages":[{"title":"List Voices","api":"GET https://api.bland.ai/v1/voices","description":"List all voices available to your account.","href":"/api-v1/get/voices"},{"title":"Get Voice","api":"GET https://api.bland.ai/v1/voices/{id}","href":"/api-v1/get/voices-id"},{"title":"Get Voice Settings","api":"GET https://api.bland.ai/v1/voices/{id}/settings","href":"/api-v1/get/voices-id-settings"},{"title":"Update Voice Settings","api":"POST https://api.bland.ai/v1/voices/{id}/settings","href":"/api-v1/post/voices-id-settings"},{"title":"Update Voice Config","api":"PATCH https://api.bland.ai/v1/voices/{id}/config","href":"/api-v1/patch/voices-id-config"},{"title":"Rename Voice","api":"PATCH https://api.bland.ai/v1/voices/{id}/rename","href":"/api-v1/patch/voices-id-rename"},{"title":"Rate Voice","api":"POST https://api.bland.ai/v1/voices/{id}/rate","href":"/api-v1/post/voices-id-rate"},{"title":"Delete Voice","api":"DELETE https://api.bland.ai/v1/voices/{id}","href":"/api-v1/delete/voices-id"}]},{"group":"Discovery","pages":[{"title":"Check Voice Name Availability","api":"POST https://api.bland.ai/v1/voices/check_name_availability","href":"/api-v1/post/voices-check-name-availability"},{"title":"List Shared Voices","api":"GET https://api.bland.ai/v1/voices/shared","href":"/api-v1/get/voices-shared"},{"title":"Add Library Voice","api":"POST https://api.bland.ai/v1/voices/library/add/{id}","href":"/api-v1/post/voices-library-add-id"}]},{"group":"Samples","pages":[{"title":"List Voice Samples","api":"GET https://api.bland.ai/v1/voices/{id}/samples","href":"/api-v1/get/voices-id-samples"},{"title":"Add Voice Sample","api":"POST https://api.bland.ai/v1/voices/samples","href":"/api-v1/post/voices-samples"},{"title":"Get Voice Sample","api":"GET https://api.bland.ai/v1/voices/{id}/samples/{sample_id}","href":"/api-v1/get/voices-id-samples-sample-id"},{"title":"Update Voice Sample Transcriptions","api":"PATCH https://api.bland.ai/v1/voices/{id}/samples","href":"/api-v1/patch/voices-id-samples"},{"title":"Delete Voice Samples","api":"DELETE https://api.bland.ai/v1/voices/{id}/samples","href":"/api-v1/delete/voices-id-samples"}]},{"group":"Generation History","pages":[{"title":"List TTS Generations","api":"GET https://api.bland.ai/v1/speak/samples","href":"/api-v1/get/speak-samples"},{"title":"Get TTS Generation","api":"GET https://api.bland.ai/v1/speak/samples/{id}","href":"/api-v1/get/speak-samples-id"}]},{"group":"Models","pages":[{"title":"List Models (Public)","api":"GET https://api.bland.ai/v2/models","href":"/api-v2/get/models"},{"title":"List TTS Models","api":"GET https://api.bland.ai/v2/tts/models","href":"/api-v2/get/tts-models"},{"title":"List Voice Models (v1)","api":"GET https://api.bland.ai/v1/models","href":"/api-v1/get/models"}]},{"group":"Tooling","pages":[{"title":"Bland TTS","href":"/sdks/bland-tts"}]}]},{"product":"Changelog","pages":[{"title":"Changelog","href":"/changelog/08_03_2026"}]}]},"basePath":"","title":"Clone Voice - Bland","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["10e4515597","c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["BannerMarkdown-5hDu1xuu.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CnLhKuUV.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}