curl \ --request POST \ --url "https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp" \ --header "xi-api-key: $BREEZE_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "text": "I can’t believe you brought him here!", "model_id": "breeze-tts-2", "instructions": "Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.", "voice_settings": { "guidance_scale": 4.0 }}'
from pathlib import Path
from breeze_blue import save
import os
from breeze_blue import BreezeBlue
client = BreezeBlue(api_key=os.environ["BREEZE_API_KEY"])
audio = client.text_to_speech.convert(
voice_id="voc_xeh3w54cqvnp",
text="I can’t believe you brought him here!",
instructions="Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.",
model_id="breeze-tts-2",
voice_settings={"guidance_scale": 4.0},
)
save(audio, Path("out.mp3"))
import { save } from "@breeze.blue/sdk/node";
import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient({
apiKey: process.env.BREEZE_API_KEY!,
});
const audio = await client.textToSpeech.convert(
"voc_xeh3w54cqvnp",
{
text: "I can’t believe you brought him here!",
instructions: "Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.",
modelId: "breeze-tts-2",
voiceSettings: { guidanceScale: 4.0 },
},
);
await save(audio, "out.mp3");
Synthesize text to audio using the given voice. For complete JSON audio and timing, use Convert with timestamps. See Speech timing for SDK and CLI examples.
POST
/
v1
/
text-to-speech
/
{voice_id}
cURL
curl \ --request POST \ --url "https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp" \ --header "xi-api-key: $BREEZE_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "text": "I can’t believe you brought him here!", "model_id": "breeze-tts-2", "instructions": "Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.", "voice_settings": { "guidance_scale": 4.0 }}'
from pathlib import Path
from breeze_blue import save
import os
from breeze_blue import BreezeBlue
client = BreezeBlue(api_key=os.environ["BREEZE_API_KEY"])
audio = client.text_to_speech.convert(
voice_id="voc_xeh3w54cqvnp",
text="I can’t believe you brought him here!",
instructions="Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.",
model_id="breeze-tts-2",
voice_settings={"guidance_scale": 4.0},
)
save(audio, Path("out.mp3"))
import { save } from "@breeze.blue/sdk/node";
import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient({
apiKey: process.env.BREEZE_API_KEY!,
});
const audio = await client.textToSpeech.convert(
"voc_xeh3w54cqvnp",
{
text: "I can’t believe you brought him here!",
instructions: "Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.",
modelId: "breeze-tts-2",
voiceSettings: { guidanceScale: 4.0 },
},
);
await save(audio, "out.mp3");
Voice ID to use for speech generation. See List voices.
Query Parameters
output_format
enum<string>
default:mp3
The output format of the generated audio. For example, mp3_24000_128 is MP3 at 24 kHz and 128 kbps. Bitrate applies to MP3, AAC, and Opus. Default: mp3. See Output formats.
Available options:
mp3,
wav,
flac,
pcm,
aac,
opus,
mp3_24000_64,
mp3_24000_96,
mp3_24000_128,
mp3_24000_160,
wav_24000,
pcm_24000,
flac_24000,
aac_24000_128
delivery
string
default:sync
Response mode: sync returns audio; async returns a background job to poll. Default: sync. See Async jobs.
Pattern: ^(sync|async)$
Body
application/json
text
string
required
Text to synthesize. Up to 1000 characters by default; accounts with an approved higher limit may send up to their configured limit, at most 2000 characters. See Audio tags.
Minimum string length: 1
model_id
string | null
Model ID for speech generation. When omitted, the server selects a model based on the account rollout, requested language, and endpoint capabilities. See List models.
Required string length: 1 - 120
language_code
string | null
ISO 639-1 two-letter language code supported by the selected model. See supported language codes.
Binary audio stream. Content-Type matches the requested output_format.
The response is of type file.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Breeze Blue","description":"Reference documentation, guides, and quickstarts for the Breeze Developer API, SDKs, and CLI.","colors":{"primary":"#0B5AD2","light":"#3D78DC","dark":"#0B5AD2"},"logo":{"light":"https://mintcdn.com/breezeblue/HJi9cL24BjuobeR3/logo-light.png?fit=max\u0026auto=format\u0026n=HJi9cL24BjuobeR3\u0026q=85\u0026s=64b2b794b84ec5e5975584a36d52f1cd","dark":"https://mintcdn.com/breezeblue/HJi9cL24BjuobeR3/logo-dark.png?fit=max\u0026auto=format\u0026n=HJi9cL24BjuobeR3\u0026q=85\u0026s=f5a080d68beff8740d65ef033ab6b564","href":"https://breezeblue.ai"},"favicon":"https://mintcdn.com/breezeblue/uwKEVtPuSz6xAzRM/favicon.png?fit=max\u0026auto=format\u0026n=uwKEVtPuSz6xAzRM\u0026q=85\u0026s=341474510af96418bfb8d36f42125d88","api":{"examples":{"autogenerate":false}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://breezeblue.ai","label":"Breeze Blue"},{"href":"https://breezeblue.ai/app/developer","label":"Developer Console"}],"primary":{"type":"button","label":"Open Studio","href":"https://breezeblue.ai/app"}},"footer":{"socials":{"website":"https://breezeblue.ai","discord":"https://discord.gg/6H7AgPe9pA","x":"https://x.com/BreezeBlueX"},"links":[{"header":"Product","items":[{"label":"Creator","href":"https://breezeblue.ai/app"},{"label":"API","href":"/api-reference/introduction"},{"label":"CLI","href":"/cli"}]},{"header":"Explore","items":[{"label":"Bluebell","href":"https://breezeblue.ai/bluebell"},{"label":"Voice Galaxy","href":"https://breezeblue.ai/labs/voice-galaxy"}]},{"header":"Company","items":[{"label":"About","href":"https://breezeblue.ai/about"},{"label":"Blog","href":"https://breezeblue.ai/blog"},{"label":"Contact","href":"https://breezeblue.ai/contact"},{"label":"Email","href":"mailto:[email protected]"}]},{"header":"Legal","items":[{"label":"Privacy","href":"https://breezeblue.ai/legal/privacy"},{"label":"Terms","href":"https://breezeblue.ai/legal/terms"}]}]},"seo":{"metatags":{"google-site-verification":"eAqPjwtfRocfzlfoMcCcsjpUiDlOBlWswzYSNGb_D4s"},"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","download-spec","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"breezeblue","hasAudioNarration":false,"actualSubdomain":"breezeblue","customDomains":["docs.breezeblue.ai"],"gitSource":{"type":"github","owner":"breezebluestudio","repo":"breezebluestudio","deployBranch":"main","contentDirectory":"developer-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afc282e78a7e52fb2750d98","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":88},{"language":"default","tag":"Studio","count":42},{"language":"default","tag":"Documentation","count":24},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"CLI Reference","count":13},{"language":"default","tag":"Account","count":12},{"language":"default","tag":"Voice Previews","count":11},{"language":"default","tag":"Text to Speech","count":8},{"language":"default","tag":"Voices","count":6},{"language":"default","tag":"Get started","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#api-playground-2-operation-page .mdx-content:has(>.api-next-steps){display:flex;flex-direction:column}#api-playground-2-operation-page .mdx-content>.api-next-steps{order:1}"}],"page":{"pagePath":"api-reference/text-to-speech/convert-text-to-speech","slug":"/api-reference/text-to-speech/convert-text-to-speech","pageMetadata":{"title":"Convert text to speech","description":"Synthesize text to audio using the given voice. For complete JSON audio and timing, use [Convert with timestamps](https://docs.breezeblue.ai/api-reference/text-to-speech/convert-with-timestamps). See [Speech timing](https://docs.breezeblue.ai/guides/speech-timing) for SDK and CLI examples.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}","href":"/api-reference/text-to-speech/convert-text-to-speech","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Synthesize text to audio using the given voice. For complete JSON audio and timing, use \", _jsx(_components.a, {\n href: \"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-with-timestamps\",\n children: \"Convert with timestamps\"\n }), \". See \", _jsx(_components.a, {\n href: \"https://docs.breezeblue.ai/guides/speech-timing\",\n children: \"Speech timing\"\n }), \" for SDK and CLI examples.\"]\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const{Card,Columns,Heading}={..._provideComponents(),...props.components};if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(`section`,{className:`api-next-steps`,\"aria-label\":`Continue building`,children:[_jsx(Heading,{level:`2`,id:`continue-building`,children:`Continue building`}),_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Write instructions`,icon:`sliders-horizontal`,href:`/guides/voice-instruction-prompting`,children:`Choose intent, emotion, and delivery.`}),_jsx(Card,{title:`Convert with timestamps`,icon:`braces`,href:`/api-reference/text-to-speech/convert-with-timestamps`,children:`Get complete audio with word timing.`}),_jsx(Card,{title:`Stream text to speech`,icon:`radio`,href:`/api-reference/text-to-speech/stream-text-to-speech`,children:`Receive audio as it is generated.`}),_jsx(Card,{title:`Text to speech`,icon:`audio-lines`,href:`/guides/text-to-speech`,children:`Follow HTTP, SDK, and async examples.`})]})]})}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":"Convert text to speech","description":"Synthesize text to audio using the given voice. For complete JSON audio and timing, use [Convert with timestamps](https://docs.breezeblue.ai/api-reference/text-to-speech/convert-with-timestamps). See [Speech timing](https://docs.breezeblue.ai/guides/speech-timing) for SDK and CLI examples.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}","href":"/api-reference/text-to-speech/convert-text-to-speech","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Continue building","slug":"continue-building","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Text to Speech"],"summary":"Convert text to speech","description":"Synthesize text to audio using the given voice. For complete JSON audio and timing, use [Convert with timestamps](https://docs.breezeblue.ai/api-reference/text-to-speech/convert-with-timestamps). See [Speech timing](https://docs.breezeblue.ai/guides/speech-timing) for SDK and CLI examples.","operationId":"tts_generate","parameters":["fc94438a-5f42-4428-9eb4-47b7cf9520c8","a9ccc478-e0b1-41b6-b27f-2bcd1b806ad3","64043326-1fdb-4ee2-a4d6-ff0e167a2dee"],"requestBody":"61df3cb5-e461-4119-a99a-7a3d4d3520cb","responses":{"200":"850572d8-67af-46ae-b2ae-345458ca7d94","202":"9f17348e-3ce1-4d4c-8652-33ddb50dce80","400":"22d458a0-aea7-4734-a11d-d455c8704164","401":"8c2f7810-4a52-4bb8-b339-b98867642dba","403":"c08f7e23-9e25-4a28-a9e4-6d3284c7d390","404":"69ea8f24-6e65-4ab0-b42e-119ee1d1215a","422":"844fac71-4ee6-4ff1-bf04-c81cd962c495","429":"1534b153-b43b-4c5d-b656-7e6218f4b74a","503":"7a8c1084-a263-4da9-9985-8bf3e67fbffd","504":"2ca472d1-c4e4-489a-aaec-fb1ff9d94470"},"x-mint":{"content":"\u003csection className=\"api-next-steps\" aria-label=\"Continue building\">\n\n## Continue building\n\n\u003cColumns cols={2}>\n\u003cCard title=\"Write instructions\" icon=\"sliders-horizontal\" href=\"/guides/voice-instruction-prompting\">Choose intent, emotion, and delivery.\u003c/Card>\n\u003cCard title=\"Convert with timestamps\" icon=\"braces\" href=\"/api-reference/text-to-speech/convert-with-timestamps\">Get complete audio with word timing.\u003c/Card>\n\u003cCard title=\"Stream text to speech\" icon=\"radio\" href=\"/api-reference/text-to-speech/stream-text-to-speech\">Receive audio as it is generated.\u003c/Card>\n\u003cCard title=\"Text to speech\" icon=\"audio-lines\" href=\"/guides/text-to-speech\">Follow HTTP, SDK, and async examples.\u003c/Card>\n\u003c/Columns>\n\n\u003c/section>"},"x-breeze-api-name":"Convert text to speech","x-breeze-docs-group":"Text to Speech","x-breeze-docs-href":"/docs/api-reference/text-to-speech/convert","x-breeze-errors":[{"code":"VALIDATION_ERROR","description":"The request body failed schema validation."},{"code":"BAD_REQUEST","description":"The request body or query parameter is not valid for this endpoint."},{"code":"RESOURCE_NOT_FOUND","description":"The voice_id does not exist or is not accessible."},{"code":"GENERATION_CONCURRENCY_EXCEEDED","description":"Your plan's concurrent generation limit was reached. Please retry shortly."},{"code":"GENERATION_CAPACITY_EXCEEDED","description":"Inference capacity refusals return 429; service-unavailable and shared processing capacity responses remain 503. Generation is not automatically replayed."},{"code":"UPSTREAM_GENERATION_ERROR","description":"The downstream generation service failed."},{"code":"UPSTREAM_TIMEOUT","description":"The downstream generation service timed out."}],"x-breeze-notes":["Use voice_settings.guidance_scale to adjust how strongly generation follows the prompt and reference voice. Accepted range: 1.0 to 10.0.","BreezeBlue generates native 24 kHz mono audio."],"security":["19eb2436-7809-4775-8a7d-37b599681306"],"x-codeSamples":[{"lang":"cURL","label":"cURL","source":"curl \\\n --request POST \\\n --url \"https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp\" \\\n --header \"xi-api-key: $BREEZE_API_KEY\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"text\": \"I can’t believe you brought him here!\",\n \"model_id\": \"breeze-tts-2\",\n \"instructions\": \"Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.\",\n \"voice_settings\": {\n \"guidance_scale\": 4.0\n }\n}'"},{"lang":"Python","label":"Python SDK","source":"from pathlib import Path\n\nfrom breeze_blue import save\n\nimport os\n\nfrom breeze_blue import BreezeBlue\n\nclient = BreezeBlue(api_key=os.environ[\"BREEZE_API_KEY\"])\n\naudio = client.text_to_speech.convert(\n voice_id=\"voc_xeh3w54cqvnp\",\n text=\"I can’t believe you brought him here!\",\n instructions=\"Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.\",\n model_id=\"breeze-tts-2\",\n voice_settings={\"guidance_scale\": 4.0},\n)\nsave(audio, Path(\"out.mp3\"))"},{"lang":"TypeScript","label":"TypeScript SDK","source":"import { save } from \"@breeze.blue/sdk/node\";\nimport { BreezeBlueClient } from \"@breeze.blue/sdk\";\n\nconst client = new BreezeBlueClient({\n apiKey: process.env.BREEZE_API_KEY!,\n});\n\nconst audio = await client.textToSpeech.convert(\n \"voc_xeh3w54cqvnp\",\n {\n text: \"I can’t believe you brought him here!\",\n instructions: \"Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.\",\n modelId: \"breeze-tts-2\",\n voiceSettings: { guidanceScale: 4.0 },\n },\n);\nawait save(audio, \"out.mp3\");"}],"method":"post","type":"path","servers":["11fb8294-1ccc-4bab-89f3-d0b5db9fd0b5"],"path":"/v1/text-to-speech/{voice_id}","baseUrlOptions":["https://api.breeze.blue"],"title":"Convert text to speech","codeSamples":[{"label":"cURL","lang":"cURL","source":"curl \\\n --request POST \\\n --url \"https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp\" \\\n --header \"xi-api-key: $BREEZE_API_KEY\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"text\": \"I can’t believe you brought him here!\",\n \"model_id\": \"breeze-tts-2\",\n \"instructions\": \"Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.\",\n \"voice_settings\": {\n \"guidance_scale\": 4.0\n }\n}'"},{"label":"Python SDK","lang":"Python","source":"from pathlib import Path\n\nfrom breeze_blue import save\n\nimport os\n\nfrom breeze_blue import BreezeBlue\n\nclient = BreezeBlue(api_key=os.environ[\"BREEZE_API_KEY\"])\n\naudio = client.text_to_speech.convert(\n voice_id=\"voc_xeh3w54cqvnp\",\n text=\"I can’t believe you brought him here!\",\n instructions=\"Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.\",\n model_id=\"breeze-tts-2\",\n voice_settings={\"guidance_scale\": 4.0},\n)\nsave(audio, Path(\"out.mp3\"))"},{"label":"TypeScript SDK","lang":"TypeScript","source":"import { save } from \"@breeze.blue/sdk/node\";\nimport { BreezeBlueClient } from \"@breeze.blue/sdk\";\n\nconst client = new BreezeBlueClient({\n apiKey: process.env.BREEZE_API_KEY!,\n});\n\nconst audio = await client.textToSpeech.convert(\n \"voc_xeh3w54cqvnp\",\n {\n text: \"I can’t believe you brought him here!\",\n instructions: \"Say it softly and emotionally, with a hurt, disappointed tone, as if bringing him here broke your trust.\",\n modelId: \"breeze-tts-2\",\n voiceSettings: { guidanceScale: 4.0 },\n },\n);\nawait save(audio, \"out.mp3\");"}],"requiredOnlyExamples":false,"disableCodeSampleGeneration":true,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"fc94438a-5f42-4428-9eb4-47b7cf9520c8":{"name":"voice_id","in":"path","required":true,"schema":{"title":"Voice Id","type":"string","isRequired":true,"description":"Voice ID to use for speech generation. See [List voices](https://docs.breezeblue.ai/api-reference/voices/list-voices).","uniqueKey":"","typeLabel":"string"},"description":"Voice ID to use for speech generation. See [List voices](https://docs.breezeblue.ai/api-reference/voices/list-voices)."},"a9ccc478-e0b1-41b6-b27f-2bcd1b806ad3":{"name":"output_format","in":"query","required":false,"schema":{"type":"string","title":"Output Format","default":"mp3","enum":["mp3","wav","flac","pcm","aac","opus","mp3_24000_64","mp3_24000_96","mp3_24000_128","mp3_24000_160","wav_24000","pcm_24000","flac_24000","aac_24000_128"],"isRequired":false,"description":"The output format of the generated audio. For example, mp3_24000_128 is MP3 at 24 kHz and 128 kbps. Bitrate applies to MP3, AAC, and Opus. Default: mp3. See [Output formats](https://docs.breezeblue.ai/concepts/output-format).","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"The output format of the generated audio. For example, mp3_24000_128 is MP3 at 24 kHz and 128 kbps. Bitrate applies to MP3, AAC, and Opus. Default: mp3. See [Output formats](https://docs.breezeblue.ai/concepts/output-format)."},"64043326-1fdb-4ee2-a4d6-ff0e167a2dee":{"name":"delivery","in":"query","required":false,"schema":{"type":"string","pattern":"^(sync|async)$","default":"sync","title":"Delivery","isRequired":false,"description":"Response mode: sync returns audio; async returns a background job to poll. Default: sync. See [Async jobs](https://docs.breezeblue.ai/guides/text-to-speech#async-jobs).","uniqueKey":"","typeLabel":"string"},"description":"Response mode: sync returns audio; async returns a background job to poll. Default: sync. See [Async jobs](https://docs.breezeblue.ai/guides/text-to-speech#async-jobs)."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"type":"string","minLength":1,"title":"Text","description":"Text to synthesize. Up to 1000 characters by default; accounts with an approved higher limit may send up to their configured limit, at most 2000 characters. See [Audio tags](https://docs.breezeblue.ai/guides/audio-tags).","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"model_id":{"oneOf":[{"type":"string","title":"Model Id","description":"Model ID for speech generation. When omitted, the server selects a model based on the account rollout, requested language, and endpoint capabilities. See [List models](https://docs.breezeblue.ai/api-reference/models/list-models).","maxLength":120,"minLength":1,"uniqueKey":"model_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model Id","description":"Model ID for speech generation. When omitted, the server selects a model based on the account rollout, requested language, and endpoint capabilities. See [List models](https://docs.breezeblue.ai/api-reference/models/list-models).","uniqueKey":"model_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"model_id","typeLabel":"string | null"},"language_code":{"oneOf":[{"type":"string","title":"Language Code","description":"ISO 639-1 two-letter language code supported by the selected model. See [supported language codes](https://docs.breezeblue.ai/concepts/multilingual).","maxLength":2,"minLength":2,"pattern":"^[A-Za-z]{2}$","uniqueKey":"language_code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Language Code","description":"ISO 639-1 two-letter language code supported by the selected model. See [supported language codes](https://docs.breezeblue.ai/concepts/multilingual).","uniqueKey":"language_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"language_code","typeLabel":"string | null"},"instructions":{"oneOf":[{"type":"string","title":"Instructions","description":"Performance instructions, written in the same language as the input text. Leading and trailing whitespace is removed. See [Expressive controls](https://docs.breezeblue.ai/guides/text-to-speech#tuning-expressive-controls), [Voice instruction prompting](https://docs.breezeblue.ai/guides/voice-instruction-prompting).","uniqueKey":"instructions.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instructions","description":"Performance instructions, written in the same language as the input text. Leading and trailing whitespace is removed. See [Expressive controls](https://docs.breezeblue.ai/guides/text-to-speech#tuning-expressive-controls), [Voice instruction prompting](https://docs.breezeblue.ai/guides/voice-instruction-prompting).","uniqueKey":"instructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"instructions","typeLabel":"string | null"},"voice_settings":{"oneOf":[{"type":"object","title":"TtsVoiceSettingsPayload","description":"Per-request voice settings. See [Expressive controls](https://docs.breezeblue.ai/guides/text-to-speech#tuning-expressive-controls).","properties":{"guidance_scale":{"oneOf":[{"type":"number","title":"Guidance Scale","description":"Generation guidance strength. Accepted range: 1.0 to 10.0. Default: 1.0. See [Expressive controls](https://docs.breezeblue.ai/guides/text-to-speech#tuning-expressive-controls).","maximum":10,"minimum":1,"uniqueKey":"voice_settings.oneOf.0.guidance_scale.oneOf.0","typeLabel":"number"},{"type":"null","title":"Guidance Scale","description":"Generation guidance strength. Accepted range: 1.0 to 10.0. Default: 1.0. See [Expressive controls](https://docs.breezeblue.ai/guides/text-to-speech#tuning-expressive-controls).","uniqueKey":"voice_settings.oneOf.0.guidance_scale.oneOf.1","typeLabel":"null"}],"uniqueKey":"voice_settings.oneOf.0.guidance_scale","typeLabel":"number | null"},"speed":{"type":"number","maximum":2,"minimum":0.5,"title":"Speed","description":"Speech speed multiplier that preserves pitch. Range: 0.5–2.0; default: 1.0.","default":1,"uniqueKey":"voice_settings.oneOf.0.speed","typeLabel":"number"},"volume":{"type":"number","maximum":2,"minimum":0.01,"title":"Volume","description":"Request-only linear amplitude multiplier. Range: 0.01–2.0 (1%–200%); default: 1.0. Values above 1.0 may clip peaks. Does not normalize loudness.","default":1,"uniqueKey":"voice_settings.oneOf.0.volume","typeLabel":"number"},"use_speaker_boost":{"type":"boolean","title":"Use Speaker Boost","description":"Improve similarity to the reference voice. Default: false. Ignored when instructions are non-empty and guidance_scale is above 1; otherwise, when true, guidance_scale is applied as 1. Instructions are always applied.","default":false,"uniqueKey":"voice_settings.oneOf.0.use_speaker_boost","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"voice_settings.oneOf.0","typeLabel":"TtsVoiceSettingsPayload · object"},{"type":"null","description":"Per-request voice settings. See [Expressive controls](https://docs.breezeblue.ai/guides/text-to-speech#tuning-expressive-controls).","uniqueKey":"voice_settings.oneOf.1","typeLabel":"null"}],"uniqueKey":"voice_settings","typeLabel":"TtsVoiceSettingsPayload · object | null"}},"additionalProperties":false,"type":"object","required":["text"],"title":"TtsRequest","uniqueKey":"","typeLabel":"TtsRequest · object"},"examples":{"Example":{"title":"Example","value":{"text":"\u003cstring>","model_id":"\u003cstring>","language_code":"\u003cstring>","instructions":"\u003cstring>","voice_settings":{"guidance_scale":5.5,"speed":1,"volume":1,"use_speaker_boost":false}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"850572d8-67af-46ae-b2ae-345458ca7d94":{"description":"Binary audio stream. Content-Type matches the requested output_format.","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"audio/wav":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"audio/flac":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"audio/aac":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"audio/opus":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"audio/pcm":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"headers":{"history-item-id":{"description":"History item ID for the generated audio.","schema":{"type":"string"}},"x-breeze-api-key-id":{"description":"Public API key identifier used to authenticate the request, when an API key was used.","schema":{"type":"string"}}},"exampleType":"generated"},"9f17348e-3ce1-4d4c-8652-33ddb50dce80":{"description":"Accepted background TTS job.","content":{"application/json":{"schema":{"properties":{"generation_job_id":{"title":"Generation Job Id","type":"string","isRequired":true,"uniqueKey":"generation_job_id","typeLabel":"string"},"history_item_id":{"title":"History Item Id","type":"string","isRequired":true,"uniqueKey":"history_item_id","typeLabel":"string"},"status":{"title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["generation_job_id","history_item_id","status"],"title":"AsyncTtsJobResponse","type":"object","uniqueKey":"","typeLabel":"AsyncTtsJobResponse · object"},"examples":{"Example":{"title":"Example","value":{"generation_job_id":"\u003cstring>","history_item_id":"\u003cstring>","status":"\u003cstring>"}}},"exampleType":"generated"}},"headers":{"x-breeze-api-key-id":{"description":"Public API key identifier used to authenticate the request, when an API key was used.","schema":{"type":"string"}}},"exampleType":"generated"},"22d458a0-aea7-4734-a11d-d455c8704164":{"description":"HTTP 400 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"8c2f7810-4a52-4bb8-b339-b98867642dba":{"description":"HTTP 401 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c08f7e23-9e25-4a28-a9e4-6d3284c7d390":{"description":"HTTP 403 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"69ea8f24-6e65-4ab0-b42e-119ee1d1215a":{"description":"HTTP 404 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"844fac71-4ee6-4ff1-bf04-c81cd962c495":{"description":"HTTP 422 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ValidationErrorResponse","type":"object","uniqueKey":"","typeLabel":"ValidationErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"1534b153-b43b-4c5d-b656-7e6218f4b74a":{"description":"HTTP 429 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"When provided, seconds to wait before retrying a rate or shared-capacity rejection.","schema":{"type":"integer","minimum":0,"maximum":3600}}},"exampleType":"generated"},"7a8c1084-a263-4da9-9985-8bf3e67fbffd":{"description":"HTTP 503 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"When provided, seconds to wait before retrying a rate or shared-capacity rejection.","schema":{"type":"integer","minimum":0,"maximum":3600}},"history-item-id":{"description":"When a synchronous generation job was created, its identifier for checking history and downloading a ready result. A saved recoverable result is charged once even if the original response fails.","schema":{"type":"string"}}},"exampleType":"generated"},"2ca472d1-c4e4-489a-aaec-fb1ff9d94470":{"description":"HTTP 504 error response.","content":{"application/json":{"schema":{"properties":{"code":{"type":"string","title":"Code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","title":"Detail","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"default":false,"title":"Ok","type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta","typeLabel":"Meta · object | null"}},"required":["code","detail","error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>","error":"\u003cstring>","ok":false,"meta":{}}}},"exampleType":"generated"}},"headers":{"history-item-id":{"description":"When a synchronous generation job was created, its identifier for checking history and downloading a ready result. A saved recoverable result is charged once even if the original response fails.","schema":{"type":"string"}}},"exampleType":"generated"}},"security":{"19eb2436-7809-4775-8a7d-37b599681306":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"xi-api-key","description":"Breeze Developer API key.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"11fb8294-1ccc-4bab-89f3-d0b5db9fd0b5":{"url":"https://api.breeze.blue"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"xi-api-key","description":"Breeze Developer API key.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"xi-api-key","type":"string","description":"Breeze Developer API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"xi-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"breezeblue","siteName":"Breeze Blue","title":"Convert text to speech - Breeze Blue","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:10:59.892Z","originalFileLocation":"api-reference/text-to-speech/convert-text-to-speech.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=\"Synthesize text to audio using the given voice. For complete JSON audio and timing, use Convert with timestamps. See Speech timing for SDK and CLI examples.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Breeze Blue\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_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/breezeblue/EfwzJlIYKxgPDxPM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Convert text to speech - Breeze Blue\">\u003cmeta data-mint-head property=\"og:description\" content=\"Synthesize text to audio using the given voice. For complete JSON audio and timing, use Convert with timestamps. See Speech timing for SDK and CLI examples.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Breeze Blue\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://breezeblue.mintlify.site/_mintlify/api/og/v2?division=Text+to+Speech\u0026amp;title=Convert+text+to+speech\u0026amp;description=Synthesize+text+to+audio+using+the+given+voice.+For+complete+JSON+audio+and+timing%2C+use+%5BConvert+with+timestamps%5D%28https%3A%2F%2Fdocs.breezeblue.ai%2Fapi-reference%2Ftext-\u0026amp;theme=3740d9931486a261965ee039\u0026amp;signature=b97302a4a042904e45fbbfe54688389bb3ae9384613868e019cc5ae944ec5dac\">\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=\"Convert text to speech - Breeze Blue\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Synthesize text to audio using the given voice. For complete JSON audio and timing, use Convert with timestamps. See Speech timing for SDK and CLI examples.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://breezeblue.mintlify.site/_mintlify/api/og/v2?division=Text+to+Speech\u0026amp;title=Convert+text+to+speech\u0026amp;description=Synthesize+text+to+audio+using+the+given+voice.+For+complete+JSON+audio+and+timing%2C+use+%5BConvert+with+timestamps%5D%28https%3A%2F%2Fdocs.breezeblue.ai%2Fapi-reference%2Ftext-\u0026amp;theme=3740d9931486a261965ee039\u0026amp;signature=b97302a4a042904e45fbbfe54688389bb3ae9384613868e019cc5ae944ec5dac\">\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/breezeblue/EfwzJlIYKxgPDxPM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Breeze Blue\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0B5AD2\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"eAqPjwtfRocfzlfoMcCcsjpUiDlOBlWswzYSNGb_D4s\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/text-to-speech/convert-text-to-speech.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.breezeblue.ai/#organization\",\"name\":\"Breeze Blue\",\"url\":\"https://docs.breezeblue.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/breezeblue/HJi9cL24BjuobeR3/logo-light.png?fit=max\u0026auto=format\u0026n=HJi9cL24BjuobeR3\u0026q=85\u0026s=64b2b794b84ec5e5975584a36d52f1cd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.breezeblue.ai#website\",\"name\":\"Breeze Blue\",\"url\":\"https://docs.breezeblue.ai\",\"publisher\":{\"@id\":\"https://docs.breezeblue.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech#webpage\",\"url\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech\",\"name\":\"Convert text to speech\",\"description\":\"Synthesize text to audio using the given voice. For complete JSON audio and timing, use Convert with timestamps. See Speech timing for SDK and CLI examples.\",\"dateModified\":\"2026-11-17T10:10:59.892Z\",\"isPartOf\":{\"@id\":\"https://docs.breezeblue.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Breeze Blue\",\"item\":\"https://docs.breezeblue.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Convert text to speech\",\"item\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech#apireference\",\"headline\":\"Convert text to speech\",\"name\":\"Convert text to speech\",\"description\":\"Synthesize text to audio using the given voice. For complete JSON audio and timing, use Convert with timestamps. See Speech timing for SDK and CLI examples.\",\"url\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech\",\"mainEntityOfPage\":{\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech#webpage\"},\"dateModified\":\"2026-11-17T10:10:59.892Z\",\"publisher\":{\"@id\":\"https://docs.breezeblue.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.breezeblue.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Breeze Blue\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Breeze Blue\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/text-to-speech/convert-text-to-speech.md","siteName":"Breeze Blue","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","icon":"braces","pages":[{"title":"API reference introduction","href":"/api-reference/introduction"}]},{"group":"Models","pages":[{"title":"List models","description":"List TTS models available to the authenticated account. Each model includes a human-readable description and the ISO 639-1 language codes accepted by that model.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/models","href":"/api-reference/models/list-models"}]},{"group":"Text to Speech","pages":[{"title":"Convert text to speech","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}","href":"/api-reference/text-to-speech/convert-text-to-speech"},{"title":"Convert with timestamps","description":"Generate speech with word timestamps. Returns one complete JSON response, or a background job with delivery=async.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}/with-timestamps","href":"/api-reference/text-to-speech/convert-with-timestamps"},{"title":"Get generation job","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/generation-jobs/{generation_job_id}","href":"/api-reference/text-to-speech/get-generation-job"},{"title":"Download generation job audio","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/generation-jobs/{generation_job_id}/audio","href":"/api-reference/text-to-speech/download-generation-job-audio"},{"title":"Stream text to speech","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}/stream","href":"/api-reference/text-to-speech/stream-text-to-speech"},{"title":"Stream speech with word timestamps","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}/stream/with-timestamps","href":"/api-reference/text-to-speech/stream-speech-with-word-timestamps"},{"title":"Create realtime TTS session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/{voice_id}/realtime-sessions","href":"/api-reference/text-to-speech/create-realtime-tts-session"},{"title":"Enhance text to speech instruction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-to-speech/enhance","href":"/api-reference/text-to-speech/enhance-text-to-speech-instruction"}]},{"group":"Voices","pages":[{"title":"List Voice Metadata options","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice-metadata/options","href":"/api-reference/voices/list-voice-metadata-options"},{"title":"List voices","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voices","href":"/api-reference/voices/list-voices"},{"title":"Get a voice","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voices/{voice_id}","href":"/api-reference/voices/get-a-voice"},{"title":"Delete a voice","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/voices/{voice_id}","href":"/api-reference/voices/delete-a-voice"},{"title":"Edit a voice","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/voices/{voice_id}","href":"/api-reference/voices/edit-a-voice"},{"title":"Update effective voice tags","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/voices/{voice_id}/tags","href":"/api-reference/voices/update-effective-voice-tags"}]},{"group":"Voice Previews","pages":[{"title":"Create clone preview","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/clone","href":"/api-reference/voice-previews/create-clone-preview"},{"title":"Create design previews","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/design","href":"/api-reference/voice-previews/create-design-previews"},{"title":"Stream a design preview","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/design/stream","href":"/api-reference/voice-previews/stream-a-design-preview"},{"title":"List remix presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice-previews/remix/presets","href":"/api-reference/voice-previews/list-remix-presets"},{"title":"Prepare remix preview","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/remix/prepare","href":"/api-reference/voice-previews/prepare-remix-preview"},{"title":"Create remix preview","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/remix","href":"/api-reference/voice-previews/create-remix-preview"},{"title":"Get remix preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice-previews/remix/{generation_job_id}","href":"/api-reference/voice-previews/get-remix-preview"},{"title":"Create localize preview","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/localize","href":"/api-reference/voice-previews/create-localize-preview"},{"title":"Get localize preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice-previews/localize/{generation_job_id}","href":"/api-reference/voice-previews/get-localize-preview"},{"title":"Download completed voice preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice-previews/{generated_voice_id}/stream","href":"/api-reference/voice-previews/download-completed-voice-preview"},{"title":"Save voice preview","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice-previews/{generated_voice_id}/save","href":"/api-reference/voice-previews/save-voice-preview"}]},{"group":"Account","pages":[{"title":"Get account balance","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/balance","href":"/api-reference/account/get-account-balance"},{"title":"Get account entitlements","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/entitlements","href":"/api-reference/account/get-account-entitlements"},{"title":"Get usage metering","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/usage","href":"/api-reference/account/get-usage-metering"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/api-keys","href":"/api-reference/account/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/api-keys","href":"/api-reference/account/create-an-api-key"},{"title":"Get the current API key","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/api-keys/current","href":"/api-reference/account/get-the-current-api-key"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/api-keys/{key_id}","href":"/api-reference/account/delete-an-api-key"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/api-keys/{key_id}","href":"/api-reference/account/update-an-api-key"},{"title":"Disable an API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/api-keys/{key_id}/disable","href":"/api-reference/account/disable-an-api-key"},{"title":"Enable an API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/api-keys/{key_id}/enable","href":"/api-reference/account/enable-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/api-keys/{key_id}/rotate","href":"/api-reference/account/rotate-an-api-key"},{"title":"Reset an API key credit budget","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/api-keys/{key_id}/credit-budget/reset","href":"/api-reference/account/reset-an-api-key-credit-budget"}]},{"group":"History","pages":[{"title":"List history items","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/history","href":"/api-reference/history/list-history-items"},{"title":"Get a history item","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/history/{history_item_id}","href":"/api-reference/history/get-a-history-item"},{"title":"Delete a history item","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/history/{history_item_id}","href":"/api-reference/history/delete-a-history-item"},{"title":"Download history audio","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/history/{history_item_id}/audio","href":"/api-reference/history/download-history-audio"}]},{"group":"Studio","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects","href":"/api-reference/studio/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects","href":"/api-reference/studio/create-a-project"},{"title":"Import a project","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/import","href":"/api-reference/studio/import-a-project"},{"title":"Get a project","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}","href":"/api-reference/studio/get-a-project"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/studio/projects/{project_id}","href":"/api-reference/studio/delete-a-project"},{"title":"Update a project","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}","href":"/api-reference/studio/update-a-project"},{"title":"List chapters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/chapters","href":"/api-reference/studio/list-chapters"},{"title":"Create a chapter","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/chapters","href":"/api-reference/studio/create-a-chapter"},{"title":"Reorder chapters","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/chapters/reorder","href":"/api-reference/studio/reorder-chapters"},{"title":"Get a chapter","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/chapters/{chapter_id}","href":"/api-reference/studio/get-a-chapter"},{"title":"Delete a chapter","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/studio/projects/{project_id}/chapters/{chapter_id}","href":"/api-reference/studio/delete-a-chapter"},{"title":"Rename a chapter","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/chapters/{chapter_id}","href":"/api-reference/studio/rename-a-chapter"},{"title":"Restore a chapter","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/chapters/{chapter_id}/restore","href":"/api-reference/studio/restore-a-chapter"},{"title":"List clips","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/clips","href":"/api-reference/studio/list-clips"},{"title":"Create a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/clips","href":"/api-reference/studio/create-a-clip"},{"title":"Create clips in bulk","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/clips/batch","href":"/api-reference/studio/create-clips-in-bulk"},{"title":"Update clips in bulk","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/clips/batch","href":"/api-reference/studio/update-clips-in-bulk"},{"title":"Delete clips in bulk","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/clips/bulk-delete","href":"/api-reference/studio/delete-clips-in-bulk"},{"title":"Reorder clips","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/clips/reorder","href":"/api-reference/studio/reorder-clips"},{"title":"Move clips","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/clips/move","href":"/api-reference/studio/move-clips"},{"title":"Get a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/clips/{clip_id}","href":"/api-reference/studio/get-a-clip"},{"title":"Delete a clip","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/studio/projects/{project_id}/clips/{clip_id}","href":"/api-reference/studio/delete-a-clip"},{"title":"Update a clip","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/clips/{clip_id}","href":"/api-reference/studio/update-a-clip"},{"title":"List tracks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/tracks","href":"/api-reference/studio/list-tracks"},{"title":"Create a track","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/tracks","href":"/api-reference/studio/create-a-track"},{"title":"Reorder tracks","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/tracks/reorder","href":"/api-reference/studio/reorder-tracks"},{"title":"Get a track","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/tracks/{track_id}","href":"/api-reference/studio/get-a-track"},{"title":"Delete a track","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/studio/projects/{project_id}/tracks/{track_id}","href":"/api-reference/studio/delete-a-track"},{"title":"Update a track","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/tracks/{track_id}","href":"/api-reference/studio/update-a-track"},{"title":"List instances","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/tracks/{track_id}/instances","href":"/api-reference/studio/list-instances"},{"title":"Create an instance","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/projects/{project_id}/tracks/{track_id}/instances","href":"/api-reference/studio/create-an-instance"},{"title":"Get an instance","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/projects/{project_id}/tracks/{track_id}/instances/{instance_id}","href":"/api-reference/studio/get-an-instance"},{"title":"Delete an instance","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/studio/projects/{project_id}/tracks/{track_id}/instances/{instance_id}","href":"/api-reference/studio/delete-an-instance"},{"title":"Update an instance","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/projects/{project_id}/tracks/{track_id}/instances/{instance_id}","href":"/api-reference/studio/update-an-instance"},{"title":"List files","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/files","href":"/api-reference/studio/list-files"},{"title":"Create a file","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/files","href":"/api-reference/studio/create-a-file"},{"title":"Get a file","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/studio/files/{file_id}","href":"/api-reference/studio/get-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/studio/files/{file_id}","href":"/api-reference/studio/delete-a-file"},{"title":"Rename a file","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/studio/files/{file_id}","href":"/api-reference/studio/rename-a-file"},{"title":"Get an upload URL","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/files/{file_id}/upload","href":"/api-reference/studio/get-an-upload-url"},{"title":"Complete an upload","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/files/{file_id}/complete","href":"/api-reference/studio/complete-an-upload"},{"title":"Retry file processing","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/studio/files/{file_id}/retry","href":"/api-reference/studio/retry-file-processing"}]},{"group":"Dubbing","pages":[{"title":"Create a Dubbing upload","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/dubbing/uploads","href":"/api-reference/dubbing/create-a-dubbing-upload"},{"title":"Create a Dubbing job","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/dubbing","href":"/api-reference/dubbing/create-a-dubbing-job"},{"title":"Get a Dubbing job","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/dubbing/{dubbing_id}","href":"/api-reference/dubbing/get-a-dubbing-job"}]}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli"}]}]},"basePath":"","title":"Convert text to speech - Breeze Blue","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}