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.
Use this endpoint when the complete text is available before synthesis begins. It returns a streaming raw response or a complete WAV file in one HTTP request.For LLM tokens, multiple conversational turns, and interruption support, use Realtime Speech (WebSocket). It is the primary endpoint for realtime TTS.text and voice are the only required fields. You get 48 kHz PCM frames by default, ready to play or forward to a client. Set audio.container to wav for a file you can download and open.
Use a BTTS_V3 voice. expressiveness and stability are calibrated for
it, and 48 kHz is the rate it renders natively. BTTS_V2 voices synthesize, but the
controls are not tuned for them. Read x-model to see which model a voice resolved to.
Coming from /v1/speak?container: "raw" returns bare audio frames. The v1
endpoints wrapped pcm_<rate> in a WAV header, so v1 clients usually skip 44 bytes
before playback. Doing that here removes 44 bytes of real audio. Drop the header
handling, or ask for container: "wav".
Text-to-speech is currently billed at $0.015 per 1,000 characters, the same rate on every plan. This is a limited-time launch offer, discounted from the standard $0.04 per 1,000 characters. Each request carries a minimum charge of $0.001, so very short generations bill at the minimum rather than the per-character rate.Some public-library voices carry an additional per-character creator fee. For a completed response, the charge comes back in the x-cost header. An interrupted raw stream can bill less because delivery accounting happens after that header is sent.Billing follows delivery. A synthesis that fails before any bytes are written is not charged, and a fully delivered request is charged for the whole text. If a raw response is interrupted mid-stream, billing estimates the delivered characters at synthesized-chunk granularity. Individual audio bytes cannot be mapped to exact source characters.
The text to speak. Maximum 5,000 characters.Insert a pause with <|N|>, where N is a positive number of seconds: "Welcome to Bland. <|0.8|> How can I help?"
Output sample rate in Hz: 8000, 16000, 24000, 44100, or 48000.48 kHz is what BTTS_V3 renders natively, so it is the fastest path. With mulaw, the rate is fixed at 8000 and any other value returns a 400.
raw: bare audio frames. For streaming and voice agents.
wav: one RIFF/WAVE file with a correct-length header. The full render is buffered before the first byte goes out, since a valid header needs the final size. For downloads.
Trying the endpoint by hand? Use wav. raw returns bare samples that most players cannot open.
{ "error": { "code": "voice_not_found", "message": "Voice f04af0e5-… was not found or is not accessible." }}
{ "error": { "code": "invalid_request", "message": "`voice` is required and must be a voice UUID." }}
{"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":""},"chroma":{"liveDeploymentHistoryId":"6ae11a50f21292540542c81a","collectionId":"60dbcc4e-f6f7-470b-b029-f2dcda80fcba","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae11a50f21292540542c81a"},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae11a50f21292540542c81a","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":498},{"language":"default","tag":"API Reference","count":415},{"language":"default","tag":"Legacy","count":104},{"language":"default","tag":"Documentation","count":83},{"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":"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":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n@keyframes splash-settle{0%{opacity:0;transform:scale(.86)}to{opacity:1;transform:none}}@keyframes splash-breathe{0%,38%,88%,to{opacity:1}50%,76%{opacity:0}}.card h2+.prose{margin-top:.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)}@media (prefers-reduced-motion:no-preference){.splash-settle{animation:splash-settle 380ms cubic-bezier(.22,.61,.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(.22,.61,.36,1)}.splash-cell:hover{transform:scale(1.09);z-index:1}}.splash-diffuse,.splash-frame-a{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-diffuse,.splash-frame-a{grid-template-columns:repeat(72,var(--splash-module))}.splash-frame-a{display:grid;grid-template-rows:repeat(8,var(--splash-module))}.splash-diffuse{display:none;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)}}.dark #sidebar-content,:root[class~=dark] #sidebar-content{background:#0f0f0f;border-right-color:#ffffff12}#navigation-items{padding-right:1rem;padding-top:1.5rem;padding-left:.75rem;scrollbar-width:thin;scrollbar-color:transparent transparent}#sidebar-content a{font-size:13.5px;line-height:1.35;padding-top:5px;padding-bottom:5px}#navigation-items [class*=scroll-area-fade-size]{padding-left:0;padding-right:0}#sidebar-content [class*=font-semibold]:not(a),#sidebar-content h5{font-size:11px;letter-spacing:.06em;text-transform:uppercase;opacity:.55;margin-top:1.5rem;margin-bottom:.35rem}#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)}.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-v2/post/tts","slug":"/api-v2/post/tts","pageMetadata":{"title":"Synthesize Speech (HTTP)","api":"POST https://api.bland.ai/v2/tts","description":"Generate speech from a complete input string over HTTP.","href":"/api-v2/post/tts"},"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: \"Generate speech from a complete input string over HTTP.\"\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`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_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(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Use this endpoint when the complete text is available before synthesis begins. It returns a streaming raw response or a complete WAV file in one HTTP request.`}),`\n`,_jsxs(_components.p,{children:[`For LLM tokens, multiple conversational turns, and interruption support, use `,_jsx(_components.a,{href:`/api-v2/post/tts-ws`,children:`Realtime Speech (WebSocket)`}),`. It is the primary endpoint for realtime TTS.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`text`}),` and `,_jsx(_components.code,{children:`voice`}),` are the only required fields. You get 48 kHz PCM frames by default, ready to play or forward to a client. Set `,_jsx(_components.code,{children:`audio.container`}),` to `,_jsx(_components.code,{children:`wav`}),` for a file you can download and open.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Use a `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`BTTS_V3`})}),` voice. `,_jsx(_components.code,{children:`expressiveness`}),` and `,_jsx(_components.code,{children:`stability`}),` are calibrated for\nit, and 48 kHz is the rate it renders natively. `,_jsx(_components.code,{children:`BTTS_V2`}),` voices synthesize, but the\ncontrols are not tuned for them. Read `,_jsx(_components.code,{children:`x-model`}),` to see which model a voice resolved to.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Coming from `,_jsx(_components.code,{children:`/v1/speak`}),`?`]}),` `,_jsx(_components.code,{children:`container: \"raw\"`}),` returns bare audio frames. The v1\nendpoints wrapped `,_jsx(_components.code,{children:`pcm_\u003crate>`}),` in a WAV header, so v1 clients usually skip 44 bytes\nbefore playback. Doing that here removes 44 bytes of real audio. Drop the header\nhandling, or ask for `,_jsx(_components.code,{children:`container: \"wav\"`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`pricing`,children:`Pricing`}),`\n`,_jsxs(_components.p,{children:[`Text-to-speech is currently billed at `,_jsx(_components.strong,{children:`$0.015 per 1,000 characters`}),`, the same rate on every plan. This is a limited-time launch offer, discounted from the standard $0.04 per 1,000 characters. Each request carries a minimum charge of $0.001, so very short generations bill at the minimum rather than the per-character rate.`]}),`\n`,_jsxs(_components.p,{children:[`Some public-library voices carry an additional per-character creator fee. For a completed response, the charge comes back in the `,_jsx(_components.code,{children:`x-cost`}),` header. An interrupted raw stream can bill less because delivery accounting happens after that header is sent.`]}),`\n`,_jsxs(_components.p,{children:[`Billing follows delivery. A synthesis that fails before any bytes are written is not charged, and a fully delivered request is charged for the whole `,_jsx(_components.code,{children:`text`}),`. If a raw response is interrupted mid-stream, billing estimates the delivered characters at synthesized-chunk granularity. Individual audio bytes cannot be mapped to exact source characters.`]}),`\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.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsxs(ParamField,{body:`text`,type:`string`,required:true,id:`param-text`,children:[_jsx(_components.p,{children:`The text to speak. Maximum 5,000 characters.`}),_jsxs(_components.p,{children:[`Insert a pause with `,_jsx(_components.code,{children:`\u003c|N|>`}),`, where N is a positive number of seconds: `,_jsx(_components.code,{children:`\"Welcome to Bland. \u003c|0.8|> How can I help?\"`})]})]}),`\n`,_jsx(ParamField,{body:`voice`,type:`string`,required:true,id:`param-voice`,children:_jsxs(_components.p,{children:[`Voice UUID. Names are not accepted. Get a UUID from `,_jsx(_components.a,{href:`/api-v1/get/voices`,children:`List Voices`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`audio`,type:`object`,id:`param-audio`,children:[_jsx(_components.p,{children:`Output format. All fields optional.`}),_jsxs(Expandable,{title:`audio fields`,children:[_jsxs(ParamField,{body:`encoding`,type:`string`,default:`pcm_s16le`,id:`param-encoding`,children:[_jsx(_components.p,{children:`Audio codec.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`pcm_s16le`}),`: 16-bit signed little-endian PCM.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`mulaw`}),`: 8-bit mu-law, 8 kHz only. For telephony.`]}),`\n`]})]}),_jsxs(ParamField,{body:`sample_rate`,type:`number`,default:`48000`,id:`param-sample-rate`,children:[_jsxs(_components.p,{children:[`Output sample rate in Hz: `,_jsx(_components.code,{children:`8000`}),`, `,_jsx(_components.code,{children:`16000`}),`, `,_jsx(_components.code,{children:`24000`}),`, `,_jsx(_components.code,{children:`44100`}),`, or `,_jsx(_components.code,{children:`48000`}),`.`]}),_jsxs(_components.p,{children:[`48 kHz is what `,_jsx(_components.code,{children:`BTTS_V3`}),` renders natively, so it is the fastest path. With `,_jsx(_components.code,{children:`mulaw`}),`, the rate is fixed at `,_jsx(_components.code,{children:`8000`}),` and any other value returns a `,_jsx(_components.code,{children:`400`}),`.`]})]}),_jsxs(ParamField,{body:`container`,type:`string`,default:`raw`,id:`param-container`,children:[_jsx(_components.p,{children:`How the bytes are framed.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`raw`}),`: bare audio frames. For streaming and voice agents.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`wav`}),`: one RIFF/WAVE file with a correct-length header. The full render is buffered before the first byte goes out, since a valid header needs the final size. For downloads.`]}),`\n`]}),_jsxs(_components.p,{children:[`Trying the endpoint by hand? Use `,_jsx(_components.code,{children:`wav`}),`. `,_jsx(_components.code,{children:`raw`}),` returns bare samples that most players cannot open.`]})]})]})]}),`\n`,_jsxs(ParamField,{body:`controls`,type:`object`,id:`param-controls`,children:[_jsxs(_components.p,{children:[`How the voice performs. Both are optional and range from `,_jsx(_components.code,{children:`0.0`}),` to `,_jsx(_components.code,{children:`1.0`}),`.`]}),_jsxs(Expandable,{title:`controls fields`,children:[_jsx(ParamField,{body:`expressiveness`,type:`number`,id:`param-expressiveness`,children:_jsx(_components.p,{children:`Higher is more varied intonation; lower is flatter and more monotone.`})}),_jsx(ParamField,{body:`stability`,type:`number`,id:`param-stability`,children:_jsx(_components.p,{children:`Higher is more consistent between renders; lower is more creative and varied.`})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Audio in the encoding and container you asked for.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`raw`}),` + `,_jsx(_components.code,{children:`pcm_s16le`}),` → `,_jsx(_components.code,{children:`Content-Type: audio/pcm`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`raw`}),` + `,_jsx(_components.code,{children:`mulaw`}),` → `,_jsx(_components.code,{children:`Content-Type: audio/basic`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`wav`}),` (any encoding) → `,_jsx(_components.code,{children:`Content-Type: audio/wav`})]}),`\n`]}),`\n`,_jsx(_components.p,{children:`These headers arrive with the first byte.`}),`\n`,_jsx(ResponseField,{name:`x-request-id`,type:`string`,id:`param-x-request-id`,children:_jsx(_components.p,{children:`Unique ID for this request. Include it in support tickets.`})}),`\n`,_jsx(ResponseField,{name:`x-model`,type:`string`,id:`param-x-model`,children:_jsxs(_components.p,{children:[`The model that produced the audio, for example `,_jsx(_components.code,{children:`btts-3`}),`. Set by the voice you chose.`]})}),`\n`,_jsx(ResponseField,{name:`x-voice-id`,type:`string`,id:`param-x-voice-id`,children:_jsx(_components.p,{children:`The voice UUID used.`})}),`\n`,_jsx(ResponseField,{name:`x-sample-rate`,type:`string`,id:`param-x-sample-rate`,children:_jsx(_components.p,{children:`Output sample rate in Hz.`})}),`\n`,_jsx(ResponseField,{name:`x-cost`,type:`string`,id:`param-x-cost`,children:_jsx(_components.p,{children:`Full-response cost in USD. It matches the final charge when the response completes; an interrupted raw stream may have a lower delivery-based charge.`})}),`\n`,_jsx(ResponseField,{name:`x-latency`,type:`string`,id:`param-x-latency`,children:_jsxs(_components.p,{children:[`Milliseconds to the first audio byte. For `,_jsx(_components.code,{children:`wav`}),`, the full render time.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`errors`,children:`Errors`}),`\n`,_jsx(_components.p,{children:`Every error returns the same shape, with a stable machine-readable code:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voice_not_found\"`}),_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:`\"Voice … was not found or is not accessible.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_request`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`A required field is missing or has the wrong shape.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`text_too_long`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`text`}),` exceeds 5,000 characters.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsupported_encoding`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audio.encoding`}),` is not an allowed value.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsupported_sample_rate`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audio.sample_rate`}),` is not allowed for the encoding.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsupported_container`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audio.container`}),` is not `,_jsx(_components.code,{children:`raw`}),` or `,_jsx(_components.code,{children:`wav`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsupported_voice`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`The voice exists but is not a `,_jsx(_components.code,{children:`BTTS_V2`}),` or `,_jsx(_components.code,{children:`BTTS_V3`}),` voice.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`insufficient_credits`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`402`}),_jsx(_components.td,{children:`The account is out of credits.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`voice_not_live`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`The professional voice is still a draft. Promote it to live first.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`voice_not_found`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`The voice UUID does not exist, or you cannot access it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`concurrency_limit_reached`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsxs(_components.td,{children:[`Your organization is at its `,_jsx(_components.a,{href:`/speech/limits`,children:`concurrent generation limit`}),`. Wait the number of seconds in `,_jsx(_components.code,{children:`Retry-After`}),`, then retry.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`synthesis_failed`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Synthesis failed before or during streaming.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(Heading,{level:`3`,id:`downloadable-wav-file`,children:`Downloadable WAV file`}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.bland.ai/v2/tts\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$BLAND_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"text\": \"Hello world.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice\": \"29158307-9893-4149-8a75-bc9ce313d64e\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"audio\": { \"encoding\": \"pcm_s16le\", \"sample_rate\": 24000, \"container\": \"wav\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"controls\": { \"expressiveness\": 0.7, \"stability\": 0.5 }`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` hello.wav`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`default-48-khz-pcm-raw`,children:`Default (48 kHz PCM, raw)`}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`8`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.bland.ai/v2/tts\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$BLAND_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"text\": \"Welcome to Bland.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice\": \"29158307-9893-4149-8a75-bc9ce313d64e\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` out.pcm`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`telephony-μ-law-8-khz`,children:`Telephony (μ-law, 8 kHz)`}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.bland.ai/v2/tts\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$BLAND_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"text\": \"Your appointment is confirmed for Tuesday at 3 PM.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice\": \"29158307-9893-4149-8a75-bc9ce313d64e\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"audio\": { \"encoding\": \"mulaw\", \"sample_rate\": 8000 }`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prompt.ulaw`})]}),`\n`]})})}),`\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":"Synthesize Speech (HTTP)","api":"POST https://api.bland.ai/v2/tts","description":"Generate speech from a complete input string over HTTP.","href":"/api-v2/post/tts"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[418,422,"Example,ResponseFiel"],[718,733,"Example)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingM"],[25026,25598,"_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`Response headers`,numberOfLines:`10`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`HTTP/2 `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`content-type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` audio/pcm`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-request-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 5f9c…-…-…`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-model`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` btts-3`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-voice-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 29158307-9893-4149-8a75-bc9ce313d64e`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-sample-rate`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 48000`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-cost`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 0.001000`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-latency`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 312`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`audio`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` bytes`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`voice_not_found`,numberOfLines:`6`,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:`6`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voice_not_found\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Voice f04af0e5-… was not found or is not accessible.\"`})]}),`\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:`invalid_request`,numberOfLines:`6`,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:`6`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"invalid_request\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:'\"`voice` is required and must be a voice UUID.\"'})]}),`\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.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Pricing","slug":"pricing","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Errors","slug":"errors","depth":3,"children":[]}]},{"title":"Examples","slug":"examples","depth":2,"children":[{"title":"Downloadable WAV file","slug":"downloadable-wav-file","depth":3,"children":[]},{"title":"Default (48 kHz PCM, raw)","slug":"default-48-khz-pcm-raw","depth":3,"children":[]},{"title":"Telephony (μ-law, 8 kHz)","slug":"telephony-μ-law-8-khz","depth":3,"children":[]}]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Response headers","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=\"http\">\u003ccode language=\"http\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">HTTP/2 \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">200\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">content-type\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> audio/pcm\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">x-request-id\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 5f9c…-…-…\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">x-model\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> btts-3\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">x-voice-id\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 29158307-9893-4149-8a75-bc9ce313d64e\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">x-sample-rate\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 48000\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">x-cost\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 0.001000\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">x-latency\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 312\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#808080\">\u0026#x3C;\u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">audio\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> bytes\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#808080\">>\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"voice_not_found","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=\"6\">\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\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"voice_not_found\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\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\">\"Voice f04af0e5-… was not found or is not accessible.\"\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":"invalid_request","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=\"6\">\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\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"invalid_request\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\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\">\"`voice` is required and must be a voice UUID.\"\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":"Synthesize Speech (HTTP)","path":"/v2/tts","servers":[{"url":"https://api.bland.ai"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"authorization":{"schema":[{"type":"string","description":"Your API key.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"text":[{"type":"string","description":"The text to speak. Maximum 5,000 characters. Insert a pause with `\u003c|N|>` , where N is a positive number of seconds: `\"Welcome to Bland. \u003c|0.8|> How can I help?\"`","required":true}],"voice":[{"type":"string","description":"Voice UUID. Names are not accepted. Get a UUID from List Voices .","required":true}],"audio":[{"type":"object","properties":{"encoding":[{"type":"string","description":"Audio codec. `pcm_s16le` : 16-bit signed little-endian PCM. `mulaw` : 8-bit mu-law, 8 kHz only. For telephony."}],"sample_rate":[{"type":"number","description":"Output sample rate in Hz: `8000` , `16000` , `24000` , `44100` , or `48000` . 48 kHz is what `BTTS_V3` renders natively, so it is the fastest path. With `mulaw` , the rate is fixed at `8000` and any other value returns a `400` ."}],"container":[{"type":"string","description":"How the bytes are framed. `raw` : bare audio frames. For streaming and voice agents. `wav` : one RIFF/WAVE file with a correct-length header. The full render is buffered before the first byte goes out, since a valid header needs the final size. For downloads. Trying the endpoint by hand? Use `wav` . `raw` returns bare samples that most players cannot open."}]},"description":"Output format. All fields optional."}],"controls":[{"type":"object","properties":{"expressiveness":[{"type":"number","description":"Higher is more varied intonation; lower is flatter and more monotone."}],"stability":[{"type":"number","description":"Higher is more consistent between renders; lower is more creative and varied."}]},"description":"How the voice performs. Both are optional and range from `0.0` to `1.0` ."}]}}],"examples":{"example":{"value":{"text":"\u003cstring>","voice":"\u003cstring>","audio":{"encoding":"\u003cstring>","sample_rate":123,"container":"\u003cstring>"},"controls":{"expressiveness":123,"stability":123}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"x-request-id":[{"type":"string","description":"Unique ID for this request. Include it in support tickets."}],"x-model":[{"type":"string","description":"The model that produced the audio, for example `btts-3` . Set by the voice you chose."}],"x-voice-id":[{"type":"string","description":"The voice UUID used."}],"x-sample-rate":[{"type":"string","description":"Output sample rate in Hz."}],"x-cost":[{"type":"string","description":"Full-response cost in USD. It matches the final charge when the response completes; an interrupted raw stream may have a lower delivery-based charge."}],"x-latency":[{"type":"string","description":"Milliseconds to the first audio byte. For `wav` , the full render time."}]}}],"examples":{"example":{"value":{"x-request-id":"\u003cstring>","x-model":"\u003cstring>","x-voice-id":"\u003cstring>","x-sample-rate":"\u003cstring>","x-cost":"\u003cstring>","x-latency":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/blandai/02e9da7d1fa2fc47/script.js"],"subdomain":"blandai","siteName":"Bland","title":"Synthesize Speech (HTTP) - Bland","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T21:40:37.309Z","originalFileLocation":"api-v2/post/tts.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=\"Generate speech from a complete input string over HTTP.\">\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=\"Synthesize Speech (HTTP) - Bland\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate speech from a complete input string over HTTP.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bland\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bland.ai/api-v2/post/tts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blandai.mintlify.app/_mintlify/api/og/v2?division=HTTP+Speech\u0026amp;title=Synthesize+Speech+%28HTTP%29\u0026amp;description=Generate+speech+from+a+complete+input+string+over+HTTP.\u0026amp;theme=60d552fdcd41dd262af0d45c\u0026amp;signature=c81782f84cd7edf9b4e88af567b90727246c2e78e32a50d5d5c02b86e2e9d8b5\">\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=\"Synthesize Speech (HTTP) - Bland\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate speech from a complete input string over HTTP.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blandai.mintlify.app/_mintlify/api/og/v2?division=HTTP+Speech\u0026amp;title=Synthesize+Speech+%28HTTP%29\u0026amp;description=Generate+speech+from+a+complete+input+string+over+HTTP.\u0026amp;theme=60d552fdcd41dd262af0d45c\u0026amp;signature=c81782f84cd7edf9b4e88af567b90727246c2e78e32a50d5d5c02b86e2e9d8b5\">\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-v2/post/tts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v2/post/tts.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-v2/post/tts#webpage\",\"url\":\"https://docs.bland.ai/api-v2/post/tts\",\"name\":\"Synthesize Speech (HTTP)\",\"description\":\"Generate speech from a complete input string over HTTP.\",\"dateModified\":\"2026-10-27T21:40:37.309Z\",\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bland.ai/api-v2/post/tts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bland.ai/api-v2/post/tts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bland\",\"item\":\"https://docs.bland.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Synthesize Speech (HTTP)\",\"item\":\"https://docs.bland.ai/api-v2/post/tts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bland.ai/api-v2/post/tts#apireference\",\"headline\":\"Synthesize Speech (HTTP)\",\"name\":\"Synthesize Speech (HTTP)\",\"description\":\"Generate speech from a complete input string over HTTP.\",\"url\":\"https://docs.bland.ai/api-v2/post/tts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bland.ai/api-v2/post/tts#webpage\"},\"dateModified\":\"2026-10-27T21:40:37.309Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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)","description":"Stream LLM text into one realtime session and receive speech as binary audio frames.","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","description":"Use Bland voices through the OpenAI text-to-speech request and error shapes.","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","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":"Synthesize Speech (HTTP) - Bland","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["10e4515597","c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["BannerMarkdown-CX_qQQOL.js","dist-BTZUMDnx.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-xpJZXxdP.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-m07pfKpT.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js"]}