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.
{ "models": [ { "model_id": "BTTS_V2", "display_name": "V2", "description": "Previous-generation TTS with multilingual output and instant single-sample cloning. Prefer V3 where its language support fits.", "sample_rates": [8000, 16000, 24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en", "de", "es", "fr", "hi", "it", "ja", "ko", "nl", "pl", "pt", "ru", "tr", "zh", "ar", "id", "sv"] }, { "model_id": "BTTS_V3", "display_name": "V3", "description": "Current-generation TTS. Bland's recommended model for new voices and integrations.", "sample_rates": [24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en"], "is_recommended": true }, { "model_id": "BTTS", "display_name": "V1", "description": "Legacy English-only TTS. Retained for backward compatibility. Prefer the recommended model for new integrations.", "sample_rates": [8000, 16000, 24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en"] } ]}
Overview
Returns the voice model generations (BTTS_V3, BTTS_V2, BTTS) with their clone eligibility and language list. Use it to map a voice’s service field to its generation, or to check which generations support Clone Voice.
Building on /v2/tts, /v2/tts/ws, or /v2/audio/speech? Use List TTS Models instead. It returns the encodings, sample rates, containers, and controls those endpoints accept. The sample_rates and max_characters fields here describe the legacy v1 speak endpoints, not the v2 request limits.
No authentication is required. Results are cached for up to 5 minutes.
Headers
string
Optional. This endpoint does not require authentication.
Response
array
Array of available models.
Show Model fields
string
Engine identifier. Use this to map a voice’s service field back to its model.
string
Human-readable name suitable for UI (for example V1, V2).
string
Short description of the model’s positioning.
number[]
Sample rates the legacy v1 speak endpoints support for this model.
number
Maximum characters per synthesis request supported by the model.
boolean
Whether Clone Voice can produce voices on this model.
string[]
Language codes supported for synthesis.
boolean
true for the model Bland currently recommends for new integrations.
{ "models": [ { "model_id": "BTTS_V2", "display_name": "V2", "description": "Previous-generation TTS with multilingual output and instant single-sample cloning. Prefer V3 where its language support fits.", "sample_rates": [8000, 16000, 24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en", "de", "es", "fr", "hi", "it", "ja", "ko", "nl", "pl", "pt", "ru", "tr", "zh", "ar", "id", "sv"] }, { "model_id": "BTTS_V3", "display_name": "V3", "description": "Current-generation TTS. Bland's recommended model for new voices and integrations.", "sample_rates": [24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en"], "is_recommended": true }, { "model_id": "BTTS", "display_name": "V1", "description": "Legacy English-only TTS. Retained for backward compatibility. Prefer the recommended model for new integrations.", "sample_rates": [8000, 16000, 24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en"] } ]}
{ "models": [ { "model_id": "BTTS_V2", "display_name": "V2", "description": "Previous-generation TTS with multilingual output and instant single-sample cloning. Prefer V3 where its language support fits.", "sample_rates": [8000, 16000, 24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en", "de", "es", "fr", "hi", "it", "ja", "ko", "nl", "pl", "pt", "ru", "tr", "zh", "ar", "id", "sv"] }, { "model_id": "BTTS_V3", "display_name": "V3", "description": "Current-generation TTS. Bland's recommended model for new voices and integrations.", "sample_rates": [24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en"], "is_recommended": true }, { "model_id": "BTTS", "display_name": "V1", "description": "Legacy English-only TTS. Retained for backward compatibility. Prefer the recommended model for new integrations.", "sample_rates": [8000, 16000, 24000, 44100], "max_characters": 1000, "can_clone": true, "languages": ["en"] } ]}
{"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":"6afcee2695c23b69d00f2474","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":516},{"language":"default","tag":"API Reference","count":419},{"language":"default","tag":"Legacy","count":104},{"language":"default","tag":"Documentation","count":97},{"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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/get/models","slug":"/api-v1/get/models","pageMetadata":{"title":"List Voice Models (v1)","api":"GET https://api.bland.ai/v1/models","description":"List the voice model generations used for cloning and the v1 voice catalog.","href":"/api-v1/get/models"},"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: \"List the voice model generations used for cloning and the v1 voice catalog.\"\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`,p:`p`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,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:[`Returns the voice model generations (`,_jsx(_components.code,{children:`BTTS_V3`}),`, `,_jsx(_components.code,{children:`BTTS_V2`}),`, `,_jsx(_components.code,{children:`BTTS`}),`) with their clone eligibility and language list. Use it to map a voice’s `,_jsx(_components.code,{children:`service`}),` field to its generation, or to check which generations support `,_jsx(_components.a,{href:`/api-v1/post/clone`,children:`Clone Voice`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Building on `,_jsx(_components.code,{children:`/v2/tts`}),`, `,_jsx(_components.code,{children:`/v2/tts/ws`}),`, or `,_jsx(_components.code,{children:`/v2/audio/speech`}),`? Use `,_jsx(_components.a,{href:`/api-v2/get/tts-models`,children:`List TTS Models`}),` instead. It returns the encodings, sample rates, containers, and controls those endpoints accept. The `,_jsx(_components.code,{children:`sample_rates`}),` and `,_jsx(_components.code,{children:`max_characters`}),` fields here describe the legacy v1 speak endpoints, not the v2 request limits.`]})}),`\n`,_jsx(_components.p,{children:`No authentication is required. Results are cached for up to 5 minutes.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,id:`param-authorization`,children:_jsx(_components.p,{children:`Optional. This endpoint does not require authentication.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`models`,type:`array`,id:`param-models`,children:[_jsx(_components.p,{children:`Array of available models.`}),_jsxs(Expandable,{title:`Model fields`,children:[_jsx(ResponseField,{name:`model_id`,type:`string`,id:`param-model-id`,children:_jsxs(_components.p,{children:[`Engine identifier. Use this to map a voice’s `,_jsx(_components.code,{children:`service`}),` field back to its model.`]})}),_jsx(ResponseField,{name:`display_name`,type:`string`,id:`param-display-name`,children:_jsxs(_components.p,{children:[`Human-readable name suitable for UI (for example `,_jsx(_components.code,{children:`V1`}),`, `,_jsx(_components.code,{children:`V2`}),`).`]})}),_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Short description of the model’s positioning.`})}),_jsx(ResponseField,{name:`sample_rates`,type:`number[]`,id:`param-sample-rates`,children:_jsx(_components.p,{children:`Sample rates the legacy v1 speak endpoints support for this model.`})}),_jsx(ResponseField,{name:`max_characters`,type:`number`,id:`param-max-characters`,children:_jsx(_components.p,{children:`Maximum characters per synthesis request supported by the model.`})}),_jsx(ResponseField,{name:`can_clone`,type:`boolean`,id:`param-can-clone`,children:_jsxs(_components.p,{children:[`Whether `,_jsx(_components.a,{href:`/api-v1/post/clone`,children:`Clone Voice`}),` can produce voices on this model.`]})}),_jsx(ResponseField,{name:`languages`,type:`string[]`,id:`param-languages`,children:_jsx(_components.p,{children:`Language codes supported for synthesis.`})}),_jsx(ResponseField,{name:`is_recommended`,type:`boolean`,id:`param-is-recommended`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` for the model Bland currently recommends for new integrations.`]})})]})]}),`\n`,`\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":"List Voice Models (v1)","api":"GET https://api.bland.ai/v1/models","description":"List the voice model generations used for cloning and the v1 voice catalog.","href":"/api-v1/get/models"}}},"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`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,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:[`Returns the voice model generations (`,_jsx(_components.code,{children:`BTTS_V3`}),`, `,_jsx(_components.code,{children:`BTTS_V2`}),`, `,_jsx(_components.code,{children:`BTTS`}),`) with their clone eligibility and language list. Use it to map a voice’s `,_jsx(_components.code,{children:`service`}),` field to its generation, or to check which generations support `,_jsx(_components.a,{href:`/api-v1/post/clone`,children:`Clone Voice`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Building on `,_jsx(_components.code,{children:`/v2/tts`}),`, `,_jsx(_components.code,{children:`/v2/tts/ws`}),`, or `,_jsx(_components.code,{children:`/v2/audio/speech`}),`? Use `,_jsx(_components.a,{href:`/api-v2/get/tts-models`,children:`List TTS Models`}),` instead. It returns the encodings, sample rates, containers, and controls those endpoints accept. The `,_jsx(_components.code,{children:`sample_rates`}),` and `,_jsx(_components.code,{children:`max_characters`}),` fields here describe the legacy v1 speak endpoints, not the v2 request limits.`]})}),`\n`,_jsx(_components.p,{children:`No authentication is required. Results are cached for up to 5 minutes.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,id:`param-authorization`,children:_jsx(_components.p,{children:`Optional. This endpoint does not require authentication.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`models`,type:`array`,id:`param-models`,children:[_jsx(_components.p,{children:`Array of available models.`}),_jsxs(Expandable,{title:`Model fields`,children:[_jsx(ResponseField,{name:`model_id`,type:`string`,id:`param-model-id`,children:_jsxs(_components.p,{children:[`Engine identifier. Use this to map a voice’s `,_jsx(_components.code,{children:`service`}),` field back to its model.`]})}),_jsx(ResponseField,{name:`display_name`,type:`string`,id:`param-display-name`,children:_jsxs(_components.p,{children:[`Human-readable name suitable for UI (for example `,_jsx(_components.code,{children:`V1`}),`, `,_jsx(_components.code,{children:`V2`}),`).`]})}),_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Short description of the model’s positioning.`})}),_jsx(ResponseField,{name:`sample_rates`,type:`number[]`,id:`param-sample-rates`,children:_jsx(_components.p,{children:`Sample rates the legacy v1 speak endpoints support for this model.`})}),_jsx(ResponseField,{name:`max_characters`,type:`number`,id:`param-max-characters`,children:_jsx(_components.p,{children:`Maximum characters per synthesis request supported by the model.`})}),_jsx(ResponseField,{name:`can_clone`,type:`boolean`,id:`param-can-clone`,children:_jsxs(_components.p,{children:[`Whether `,_jsx(_components.a,{href:`/api-v1/post/clone`,children:`Clone Voice`}),` can produce voices on this model.`]})}),_jsx(ResponseField,{name:`languages`,type:`string[]`,id:`param-languages`,children:_jsx(_components.p,{children:`Language codes supported for synthesis.`})}),_jsx(ResponseField,{name:`is_recommended`,type:`boolean`,id:`param-is-recommended`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` for the model Bland currently recommends for new integrations.`]})})]})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Response`,numberOfLines:`32`,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:`32`,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:` \"models\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BTTS_V2\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"V2\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Previous-generation TTS with multilingual output and instant single-sample cloning. Prefer V3 where its language support fits.\"`}),_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:` \"sample_rates\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`8000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`16000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`44100`}),_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:` \"max_characters\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`}),_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:` \"can_clone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"languages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"en\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"de\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"es\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"it\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ja\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ko\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ru\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"zh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ar\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sv\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BTTS_V3\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"V3\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Current-generation TTS. Bland's recommended model for new voices and integrations.\"`}),_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:` \"sample_rates\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`44100`}),_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:` \"max_characters\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`}),_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:` \"can_clone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"languages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"en\"`}),_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:` \"is_recommended\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BTTS\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"V1\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Legacy English-only TTS. Retained for backward compatibility. Prefer the recommended model for new integrations.\"`}),_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:` \"sample_rates\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`8000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`16000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`44100`}),_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:` \"max_characters\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`}),_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:` \"can_clone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"languages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"en\"`}),_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(_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:[`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":"List Voice Models (v1)","api":"GET https://api.bland.ai/v1/models","description":"List the voice model generations used for cloning and the v1 voice catalog.","href":"/api-v1/get/models"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Headers","slug":"headers","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=\"32\">\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\"> \"models\"\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:#116329;--shiki-dark:#9CDCFE\"> \"model_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BTTS_V2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"display_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"V2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Previous-generation TTS with multilingual output and instant single-sample cloning. Prefer V3 where its language support fits.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"sample_rates\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">8000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">16000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">24000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">44100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"max_characters\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"can_clone\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"languages\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"en\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"de\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"es\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"fr\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"hi\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"it\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ja\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ko\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"nl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"pl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"pt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ru\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"tr\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"zh\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ar\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sv\"\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\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BTTS_V3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"display_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"V3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Current-generation TTS. Bland's recommended model for new voices and integrations.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"sample_rates\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">24000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">44100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"max_characters\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"can_clone\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"languages\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"en\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_recommended\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\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\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BTTS\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"display_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"V1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Legacy English-only TTS. Retained for backward compatibility. Prefer the recommended model for new integrations.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"sample_rates\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">8000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">16000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">24000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">44100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"max_characters\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"can_clone\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"languages\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"en\"\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\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"List Voice Models (v1)","path":"/v1/models","servers":[{"url":"https://api.bland.ai"}],"method":"get","request":{"security":[],"parameters":{"query":{},"header":{"authorization":{"schema":[{"type":"string","description":"Optional. This endpoint does not require authentication."}]}},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"models":[{"type":"array","items":[{"type":"object","properties":{"model_id":[{"type":"string","description":"Engine identifier. Use this to map a voice’s `service` field back to its model."}],"display_name":[{"type":"string","description":"Human-readable name suitable for UI (for example `V1` , `V2` )."}],"description":[{"type":"string","description":"Short description of the model’s positioning."}],"sample_rates":[{"type":"array","items":[{"type":"number"}],"description":"Sample rates the legacy v1 speak endpoints support for this model."}],"max_characters":[{"type":"number","description":"Maximum characters per synthesis request supported by the model."}],"can_clone":[{"type":"boolean","description":"Whether Clone Voice can produce voices on this model."}],"languages":[{"type":"array","items":[{"type":"string"}],"description":"Language codes supported for synthesis."}],"is_recommended":[{"type":"boolean","description":"`true` for the model Bland currently recommends for new integrations."}]}}],"description":"Array of available models."}]}}],"examples":{"example":{"value":{"models":[{"model_id":"\u003cstring>","display_name":"\u003cstring>","description":"\u003cstring>","sample_rates":[123],"max_characters":123,"can_clone":true,"languages":["\u003cstring>"],"is_recommended":true}]}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/blandai/02e9da7d1fa2fc47/script.js"],"subdomain":"blandai","siteName":"Bland","title":"List Voice Models (v1) - Bland","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T21:40:37.310Z","originalFileLocation":"api-v1/get/models.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=\"List the voice model generations used for cloning and the v1 voice catalog.\">\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=\"List Voice Models (v1) - Bland\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the voice model generations used for cloning and the v1 voice catalog.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bland\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bland.ai/api-v1/get/models\">\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=Models\u0026amp;title=List+Voice+Models+%28v1%29\u0026amp;description=List+the+voice+model+generations+used+for+cloning+and+the+v1+voice+catalog.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=f9f488c0f7123b0514b8acd04f8b717184d33fb80af52d63d12e8a0fd925b77c\">\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=\"List Voice Models (v1) - Bland\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the voice model generations used for cloning and the v1 voice catalog.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Models\u0026amp;title=List+Voice+Models+%28v1%29\u0026amp;description=List+the+voice+model+generations+used+for+cloning+and+the+v1+voice+catalog.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=f9f488c0f7123b0514b8acd04f8b717184d33fb80af52d63d12e8a0fd925b77c\">\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/get/models\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v1/get/models.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/get/models#webpage\",\"url\":\"https://docs.bland.ai/api-v1/get/models\",\"name\":\"List Voice Models (v1)\",\"description\":\"List the voice model generations used for cloning and the v1 voice catalog.\",\"dateModified\":\"2026-10-27T21:40:37.310Z\",\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bland.ai/api-v1/get/models#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bland.ai/api-v1/get/models#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Models\",\"item\":\"https://docs.bland.ai/api-v2/get/models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Voice Models (v1)\",\"item\":\"https://docs.bland.ai/api-v1/get/models\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bland.ai/api-v1/get/models#apireference\",\"headline\":\"List Voice Models (v1)\",\"name\":\"List Voice Models (v1)\",\"description\":\"List the voice model generations used for cloning and the v1 voice catalog.\",\"url\":\"https://docs.bland.ai/api-v1/get/models\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bland.ai/api-v1/get/models#webpage\"},\"dateModified\":\"2026-10-27T21:40:37.310Z\",\"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/get/models.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","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","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","description":"List what each TTS model supports.","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","description":"A focused TTS and voice toolkit for Bland AI: CLI, Node library, and MCP server in one lightweight package.","href":"/sdks/bland-tts"}]}]},{"product":"Changelog","pages":[{"title":"Changelog","href":"/changelog/08_03_2026"}]}]},"basePath":"","title":"List Voice Models (v1) - Bland","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["10e4515597","c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["BannerMarkdown-BjdIPj1P.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DRLI_2Ue.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js"]}