Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free direct_websocket_url and fall back to websocket_url; wait for session.ready, and then exchange turn events and binary audio in the selected format. While no turn is active, send session.update with non-empty instructions (up to 1,000 characters) and wait for session.updated; the confirmed instructions apply starting with the next turn. See the Realtime TTS WebSocket guide for complete raw WebSocket, SDK, browser playback, and CLI examples.
Voice ID to use for speech generation. See List voices.
Body
application/json
output_format
enum<string>
default:pcm
Output audio encoding: pcm or mp3. Default: pcm. See Output formats.
Available options:
pcm,
mp3
model_id
string | null
Model ID for speech generation. When omitted, the server selects a model based on the account rollout and requested language. 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.
Required string length: 2
Pattern: ^[A-Za-z]{2}$
instructions
string | null
Initial performance instructions, written in the same language as the input text. Leading and trailing whitespace is removed. See Updating instructions.
Idle timeout for the WebSocket session. Defaults to 30 seconds and is capped at 180 seconds.
Required range: 1 <= x <= 180
enable_logging
boolean | null
Whether realtime turns should be stored in generation history.
Response
Realtime WebSocket session token and compatible transport URLs.
client_secret
string
required
Short-lived token for browser WebSocket connections.
websocket_url
string
required
WebSocket URL including the client_secret query parameter.
expires_at
string
required
ISO-8601 expiration timestamp for the client secret.
direct_websocket_url
string | null
Optional direct WebSocket URL without credentials in its query. Authenticate with the documented WebSocket subprotocols.
audio_format
RealtimeTtsAudioFormat · object
Selected realtime audio stream format.
Show child attributes
{"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"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/create-realtime-tts-session","slug":"/api-reference/text-to-speech/create-realtime-tts-session","pageMetadata":{"title":"Create realtime TTS session","description":"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free `direct_websocket_url` and fall back to `websocket_url`; wait for `session.ready`, and then exchange turn events and binary audio in the selected format. While no turn is active, send `session.update` with non-empty `instructions` (up to 1,000 characters) and wait for `session.updated`; the confirmed instructions apply starting with the next turn. See the [Realtime TTS WebSocket guide](https://docs.breezeblue.ai/guides/realtime-text-to-speech) for complete raw WebSocket, SDK, browser playback, and CLI examples.","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","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 code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free \", _jsx(_components.code, {\n children: \"direct_websocket_url\"\n }), \" and fall back to \", _jsx(_components.code, {\n children: \"websocket_url\"\n }), \"; wait for \", _jsx(_components.code, {\n children: \"session.ready\"\n }), \", and then exchange turn events and binary audio in the selected format. While no turn is active, send \", _jsx(_components.code, {\n children: \"session.update\"\n }), \" with non-empty \", _jsx(_components.code, {\n children: \"instructions\"\n }), \" (up to 1,000 characters) and wait for \", _jsx(_components.code, {\n children: \"session.updated\"\n }), \"; the confirmed instructions apply starting with the next turn. See the \", _jsx(_components.a, {\n href: \"https://docs.breezeblue.ai/guides/realtime-text-to-speech\",\n children: \"Realtime TTS WebSocket guide\"\n }), \" for complete raw WebSocket, SDK, browser playback, 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:`Realtime text to speech`,icon:`message-circle`,href:`/guides/realtime-text-to-speech`,children:`Manage instructions across conversation turns.`}),_jsx(Card,{title:`Convert text to speech`,icon:`braces`,href:`/api-reference/text-to-speech/convert-text-to-speech`,children:`Generate audio without word timing.`})]})]})}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":"Create realtime TTS session","description":"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free `direct_websocket_url` and fall back to `websocket_url`; wait for `session.ready`, and then exchange turn events and binary audio in the selected format. While no turn is active, send `session.update` with non-empty `instructions` (up to 1,000 characters) and wait for `session.updated`; the confirmed instructions apply starting with the next turn. See the [Realtime TTS WebSocket guide](https://docs.breezeblue.ai/guides/realtime-text-to-speech) for complete raw WebSocket, SDK, browser playback, and CLI examples.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Continue building","slug":"continue-building","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Text to Speech"],"summary":"Create realtime TTS session","description":"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free `direct_websocket_url` and fall back to `websocket_url`; wait for `session.ready`, and then exchange turn events and binary audio in the selected format. While no turn is active, send `session.update` with non-empty `instructions` (up to 1,000 characters) and wait for `session.updated`; the confirmed instructions apply starting with the next turn. See the [Realtime TTS WebSocket guide](https://docs.breezeblue.ai/guides/realtime-text-to-speech) for complete raw WebSocket, SDK, browser playback, and CLI examples.","operationId":"tts_realtime_sessions_create","parameters":["f1c8bab6-7b3f-461c-b033-f901504bd382"],"requestBody":"51109d2f-3dd3-40cf-8375-f0082f9a35de","responses":{"200":"dc9694a3-5c68-46c3-8baa-6df544cab4e6","401":"53839154-a912-40e3-b3a3-b6fc8ae9d384","403":"8a89649f-1a61-4651-81a7-c33f921f1e67","404":"dbcc3b8e-c8a0-497e-bd1d-7a6c0deb0e32","422":"03eadf71-8441-4464-b130-8ed733e8d45b","503":"ca4f1ad7-6d19-4ae6-8d06-3d1f3f5af156"},"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=\"Realtime text to speech\" icon=\"message-circle\" href=\"/guides/realtime-text-to-speech\">Manage instructions across conversation turns.\u003c/Card>\n\u003cCard title=\"Convert text to speech\" icon=\"braces\" href=\"/api-reference/text-to-speech/convert-text-to-speech\">Generate audio without word timing.\u003c/Card>\n\u003c/Columns>\n\n\u003c/section>"},"x-breeze-api-name":"Create realtime text to speech session","x-breeze-docs-group":"Text to Speech","x-breeze-docs-href":"/docs/api-reference/text-to-speech/realtime-sessions","x-breeze-errors":[{"code":"AUTH_REQUIRED","description":"Authentication is required."},{"code":"AUTH_CONFIG_MISSING","description":"Realtime session token signing is not configured."},{"code":"RESOURCE_NOT_FOUND","description":"The voice_id does not exist or is not accessible."},{"code":"VALIDATION_ERROR","description":"The request body failed schema validation."}],"x-breeze-notes":["Use this endpoint from your backend before opening a browser WebSocket. Do not expose long-lived API keys in browser code.","Choose output_format pcm (default) or mp3 when creating a session. The choice is fixed for that connection; audio is 24 kHz mono.","session.update is accepted only while the WebSocket session is idle. Only one update may be pending, and clients must wait for session.updated before starting the next turn.","Sending session.update during an active turn returns a recoverable BAD_REQUEST without interrupting that turn; the previously confirmed instructions remain in effect."],"security":["f9cc8c37-a145-4fa8-a2bf-da78411980d1"],"x-codeSamples":[{"lang":"cURL","label":"cURL","source":"curl \\\n --request POST \\\n --url \"https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp/realtime-sessions\" \\\n --header \"xi-api-key: $BREEZE_API_KEY\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"model_id\": \"breeze-tts-2\",\n \"language_code\": \"en\",\n \"instructions\": \"Keep turns responsive and conversational.\",\n \"voice_settings\": {\n \"guidance_scale\": 4.0\n },\n \"inactivity_timeout_seconds\": 30,\n \"enable_logging\": true\n}'"},{"lang":"Python","label":"Python SDK","source":"import asyncio\nfrom pathlib import Path\n\nimport os\n\nfrom breeze_blue import BreezeBlue\n\nclient = BreezeBlue(api_key=os.environ[\"BREEZE_API_KEY\"])\n\nsession = client.text_to_speech.create_realtime_session(\n voice_id=\"voc_xeh3w54cqvnp\",\n model_id=\"breeze-tts-2\",\n)\n\n\nasync def main() -> None:\n async with client.text_to_speech.connect_realtime(\n voice_id=\"voc_xeh3w54cqvnp\",\n client_secret=session[\"client_secret\"],\n websocket_url=session[\"websocket_url\"],\n direct_websocket_url=session.get(\"direct_websocket_url\"),\n ) as connection:\n async def consume_audio() -> bytes:\n audio = bytearray()\n async for event in connection:\n if event[\"type\"] == \"audio\":\n audio.extend(event[\"audio\"])\n elif event[\"type\"] == \"error\":\n raise RuntimeError(event[\"message\"])\n elif event[\"type\"] == \"turn.done\":\n return bytes(audio)\n raise RuntimeError(\"Realtime session closed before turn.done\")\n\n consumer = asyncio.create_task(consume_audio())\n await connection.start_turn(\"turn_1\")\n await connection.append_text(\"Hello from Breeze.\")\n await connection.flush()\n await connection.end_turn()\n Path(\"out.pcm\").write_bytes(await consumer)\n\n\nasyncio.run(main())"},{"lang":"TypeScript","label":"TypeScript SDK","source":"import { writeFile } from \"node:fs/promises\";\n\nimport { BreezeBlueClient } from \"@breeze.blue/sdk\";\n\nconst client = new BreezeBlueClient({\n apiKey: process.env.BREEZE_API_KEY!,\n});\n\nconst session = await client.textToSpeech.realtime.createSession(\n \"voc_xeh3w54cqvnp\",\n { modelId: \"breeze-tts-2\" },\n);\n\nconst connection = await client.textToSpeech.realtime.connect(\n \"voc_xeh3w54cqvnp\",\n {\n clientSecret: session.clientSecret,\n websocketUrl: session.websocketUrl,\n directWebsocketUrl: session.directWebsocketUrl,\n },\n);\n\nconst consumer = (async () => {\n const pcmChunks: Uint8Array[] = [];\n for await (const message of connection) {\n if (message.type === \"audio\") pcmChunks.push(message.audio);\n if (message.type === \"error\") throw new Error(message.message);\n if (message.type === \"turn.done\") return pcmChunks;\n }\n throw new Error(\"Realtime session closed before turn.done\");\n})();\n\nconnection.startTurn(\"turn_1\");\nconnection.appendText(\"Hello from Breeze.\");\nconnection.flush();\nconnection.endTurn();\n\nconst pcmChunks = await consumer;\nawait writeFile(\n \"out.pcm\",\n Buffer.concat(pcmChunks.map((chunk) => Buffer.from(chunk))),\n);\nconnection.close();"}],"method":"post","type":"path","servers":["11fb8294-1ccc-4bab-89f3-d0b5db9fd0b5"],"path":"/v1/text-to-speech/{voice_id}/realtime-sessions","baseUrlOptions":["https://api.breeze.blue"],"title":"Create realtime TTS session","codeSamples":[{"label":"cURL","lang":"cURL","source":"curl \\\n --request POST \\\n --url \"https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp/realtime-sessions\" \\\n --header \"xi-api-key: $BREEZE_API_KEY\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"model_id\": \"breeze-tts-2\",\n \"language_code\": \"en\",\n \"instructions\": \"Keep turns responsive and conversational.\",\n \"voice_settings\": {\n \"guidance_scale\": 4.0\n },\n \"inactivity_timeout_seconds\": 30,\n \"enable_logging\": true\n}'"},{"label":"Python SDK","lang":"Python","source":"import asyncio\nfrom pathlib import Path\n\nimport os\n\nfrom breeze_blue import BreezeBlue\n\nclient = BreezeBlue(api_key=os.environ[\"BREEZE_API_KEY\"])\n\nsession = client.text_to_speech.create_realtime_session(\n voice_id=\"voc_xeh3w54cqvnp\",\n model_id=\"breeze-tts-2\",\n)\n\n\nasync def main() -> None:\n async with client.text_to_speech.connect_realtime(\n voice_id=\"voc_xeh3w54cqvnp\",\n client_secret=session[\"client_secret\"],\n websocket_url=session[\"websocket_url\"],\n direct_websocket_url=session.get(\"direct_websocket_url\"),\n ) as connection:\n async def consume_audio() -> bytes:\n audio = bytearray()\n async for event in connection:\n if event[\"type\"] == \"audio\":\n audio.extend(event[\"audio\"])\n elif event[\"type\"] == \"error\":\n raise RuntimeError(event[\"message\"])\n elif event[\"type\"] == \"turn.done\":\n return bytes(audio)\n raise RuntimeError(\"Realtime session closed before turn.done\")\n\n consumer = asyncio.create_task(consume_audio())\n await connection.start_turn(\"turn_1\")\n await connection.append_text(\"Hello from Breeze.\")\n await connection.flush()\n await connection.end_turn()\n Path(\"out.pcm\").write_bytes(await consumer)\n\n\nasyncio.run(main())"},{"label":"TypeScript SDK","lang":"TypeScript","source":"import { writeFile } from \"node:fs/promises\";\n\nimport { BreezeBlueClient } from \"@breeze.blue/sdk\";\n\nconst client = new BreezeBlueClient({\n apiKey: process.env.BREEZE_API_KEY!,\n});\n\nconst session = await client.textToSpeech.realtime.createSession(\n \"voc_xeh3w54cqvnp\",\n { modelId: \"breeze-tts-2\" },\n);\n\nconst connection = await client.textToSpeech.realtime.connect(\n \"voc_xeh3w54cqvnp\",\n {\n clientSecret: session.clientSecret,\n websocketUrl: session.websocketUrl,\n directWebsocketUrl: session.directWebsocketUrl,\n },\n);\n\nconst consumer = (async () => {\n const pcmChunks: Uint8Array[] = [];\n for await (const message of connection) {\n if (message.type === \"audio\") pcmChunks.push(message.audio);\n if (message.type === \"error\") throw new Error(message.message);\n if (message.type === \"turn.done\") return pcmChunks;\n }\n throw new Error(\"Realtime session closed before turn.done\");\n})();\n\nconnection.startTurn(\"turn_1\");\nconnection.appendText(\"Hello from Breeze.\");\nconnection.flush();\nconnection.endTurn();\n\nconst pcmChunks = await consumer;\nawait writeFile(\n \"out.pcm\",\n Buffer.concat(pcmChunks.map((chunk) => Buffer.from(chunk))),\n);\nconnection.close();"}],"requiredOnlyExamples":false,"disableCodeSampleGeneration":true,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"f1c8bab6-7b3f-461c-b033-f901504bd382":{"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)."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"output_format":{"type":"string","enum":["pcm","mp3"],"title":"RealtimeOutputFormat","description":"Output audio encoding: pcm or mp3. Default: pcm. See [Output formats](https://docs.breezeblue.ai/concepts/output-format).","default":"pcm","uniqueKey":"output_format","typeLabel":"enum\u003cstring>"},"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 and requested language. 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 and requested language. 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":"Initial performance instructions, written in the same language as the input text. Leading and trailing whitespace is removed. See [Updating instructions](https://docs.breezeblue.ai/guides/realtime-text-to-speech#update-instructions-between-turns).","uniqueKey":"instructions.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instructions","description":"Initial performance instructions, written in the same language as the input text. Leading and trailing whitespace is removed. See [Updating instructions](https://docs.breezeblue.ai/guides/realtime-text-to-speech#update-instructions-between-turns).","uniqueKey":"instructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"instructions","typeLabel":"string | null"},"voice_settings":{"oneOf":[{"type":"object","title":"RealtimeTtsVoiceSettingsPayload","description":"Optional realtime 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"},"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":"RealtimeTtsVoiceSettingsPayload · object"},{"type":"null","description":"Optional realtime 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":"RealtimeTtsVoiceSettingsPayload · object | null"},"inactivity_timeout_seconds":{"oneOf":[{"type":"integer","title":"Inactivity Timeout Seconds","description":"Idle timeout for the WebSocket session. Defaults to 30 seconds and is capped at 180 seconds.","maximum":180,"minimum":1,"uniqueKey":"inactivity_timeout_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Inactivity Timeout Seconds","description":"Idle timeout for the WebSocket session. Defaults to 30 seconds and is capped at 180 seconds.","uniqueKey":"inactivity_timeout_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"inactivity_timeout_seconds","typeLabel":"integer | null"},"enable_logging":{"oneOf":[{"type":"boolean","title":"Enable Logging","description":"Whether realtime turns should be stored in generation history.","uniqueKey":"enable_logging.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Enable Logging","description":"Whether realtime turns should be stored in generation history.","uniqueKey":"enable_logging.oneOf.1","typeLabel":"null"}],"uniqueKey":"enable_logging","typeLabel":"boolean | null"}},"additionalProperties":false,"type":"object","title":"RealtimeTtsSessionRequest","uniqueKey":"","typeLabel":"RealtimeTtsSessionRequest · object"},"examples":{"Example":{"title":"Example","value":{"output_format":"pcm","model_id":"\u003cstring>","language_code":"\u003cstring>","instructions":"\u003cstring>","voice_settings":{"guidance_scale":5.5,"use_speaker_boost":false},"inactivity_timeout_seconds":90,"enable_logging":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"dc9694a3-5c68-46c3-8baa-6df544cab4e6":{"description":"Realtime WebSocket session token and compatible transport URLs.","content":{"application/json":{"schema":{"properties":{"client_secret":{"type":"string","title":"Client Secret","description":"Short-lived token for browser WebSocket connections.","isRequired":true,"uniqueKey":"client_secret","typeLabel":"string"},"websocket_url":{"type":"string","title":"Websocket Url","description":"WebSocket URL including the client_secret query parameter.","isRequired":true,"uniqueKey":"websocket_url","typeLabel":"string"},"expires_at":{"type":"string","title":"Expires At","description":"ISO-8601 expiration timestamp for the client secret.","isRequired":true,"uniqueKey":"expires_at","typeLabel":"string"},"direct_websocket_url":{"oneOf":[{"type":"string","title":"Direct Websocket Url","description":"Optional direct WebSocket URL without credentials in its query. Authenticate with the documented WebSocket subprotocols.","uniqueKey":"direct_websocket_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Direct Websocket Url","description":"Optional direct WebSocket URL without credentials in its query. Authenticate with the documented WebSocket subprotocols.","uniqueKey":"direct_websocket_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"direct_websocket_url","typeLabel":"string | null"},"audio_format":{"properties":{"codec":{"type":"string","title":"Codec","default":"pcm_s16le","uniqueKey":"audio_format.codec","typeLabel":"string"},"sample_rate":{"type":"integer","title":"Sample Rate","default":24000,"uniqueKey":"audio_format.sample_rate","typeLabel":"integer"},"channels":{"type":"integer","title":"Channels","default":1,"uniqueKey":"audio_format.channels","typeLabel":"integer"},"sample_width_bits":{"oneOf":[{"type":"integer","title":"Sample Width Bits","default":16,"uniqueKey":"audio_format.sample_width_bits.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sample Width Bits","default":16,"uniqueKey":"audio_format.sample_width_bits.oneOf.1","typeLabel":"null"}],"uniqueKey":"audio_format.sample_width_bits","typeLabel":"integer | null"},"bitrate_kbps":{"oneOf":[{"type":"integer","title":"Bitrate Kbps","uniqueKey":"audio_format.bitrate_kbps.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Bitrate Kbps","uniqueKey":"audio_format.bitrate_kbps.oneOf.1","typeLabel":"null"}],"uniqueKey":"audio_format.bitrate_kbps","typeLabel":"integer | null"}},"type":"object","title":"RealtimeTtsAudioFormat","description":"Selected realtime audio stream format.","uniqueKey":"audio_format","typeLabel":"RealtimeTtsAudioFormat · object"}},"type":"object","required":["client_secret","websocket_url","expires_at"],"title":"RealtimeTtsSessionResponse","uniqueKey":"","typeLabel":"RealtimeTtsSessionResponse · object"},"examples":{"Example":{"title":"Example","value":{"client_secret":"\u003cstring>","websocket_url":"\u003cstring>","expires_at":"\u003cstring>","direct_websocket_url":"\u003cstring>","audio_format":{"codec":"pcm_s16le","sample_rate":24000,"channels":1,"sample_width_bits":16,"bitrate_kbps":123}}}},"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"},"53839154-a912-40e3-b3a3-b6fc8ae9d384":{"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"},"8a89649f-1a61-4651-81a7-c33f921f1e67":{"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"},"dbcc3b8e-c8a0-497e-bd1d-7a6c0deb0e32":{"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"},"03eadf71-8441-4464-b130-8ed733e8d45b":{"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"},"ca4f1ad7-6d19-4ae6-8d06-3d1f3f5af156":{"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}}},"exampleType":"generated"}},"security":{"f9cc8c37-a145-4fa8-a2bf-da78411980d1":{"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":"Create realtime TTS session - Breeze Blue","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:10:59.986Z","originalFileLocation":"api-reference/text-to-speech/create-realtime-tts-session.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free direct_websocket_url and fall back to websocket_url; wait for session.ready, and then exchange turn events and binary audio in the selected format. While no turn is active, send session.update with non-empty instructions (up to 1,000 characters) and wait for session.updated; the confirmed instructions apply starting with the next turn. See the Realtime TTS WebSocket guide for complete raw WebSocket, SDK, browser playback, 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=\"Create realtime TTS session - Breeze Blue\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free direct_websocket_url and fall back to websocket_url; wait for session.ready, and then exchange turn events and binary audio in the selected format. While no turn is active, send session.update with non-empty instructions (up to 1,000 characters) and wait for session.updated; the confirmed instructions apply starting with the next turn. See the Realtime TTS WebSocket guide for complete raw WebSocket, SDK, browser playback, 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/create-realtime-tts-session\">\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=Create+realtime+TTS+session\u0026amp;description=Create+a+short-lived+browser-safe+token+for+the+realtime+text-to-speech+WebSocket.+This+HTTP+operation+only+creates+the+session.+Official+SDKs+and+the+CLI+prefe\u0026amp;theme=3740d9931486a261965ee039\u0026amp;signature=3d1a99f2dcbaae6e4337f3fc8043e4c163e2cdec42c39f347615b5960686202b\">\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=\"Create realtime TTS session - Breeze Blue\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free direct_websocket_url and fall back to websocket_url; wait for session.ready, and then exchange turn events and binary audio in the selected format. While no turn is active, send session.update with non-empty instructions (up to 1,000 characters) and wait for session.updated; the confirmed instructions apply starting with the next turn. See the Realtime TTS WebSocket guide for complete raw WebSocket, SDK, browser playback, 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=Create+realtime+TTS+session\u0026amp;description=Create+a+short-lived+browser-safe+token+for+the+realtime+text-to-speech+WebSocket.+This+HTTP+operation+only+creates+the+session.+Official+SDKs+and+the+CLI+prefe\u0026amp;theme=3740d9931486a261965ee039\u0026amp;signature=3d1a99f2dcbaae6e4337f3fc8043e4c163e2cdec42c39f347615b5960686202b\">\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/create-realtime-tts-session\">\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/create-realtime-tts-session.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/create-realtime-tts-session#webpage\",\"url\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session\",\"name\":\"Create realtime TTS session\",\"description\":\"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free direct_websocket_url and fall back to websocket_url; wait for session.ready, and then exchange turn events and binary audio in the selected format. While no turn is active, send session.update with non-empty instructions (up to 1,000 characters) and wait for session.updated; the confirmed instructions apply starting with the next turn. See the Realtime TTS WebSocket guide for complete raw WebSocket, SDK, browser playback, and CLI examples.\",\"dateModified\":\"2026-11-17T10:10:59.986Z\",\"isPartOf\":{\"@id\":\"https://docs.breezeblue.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Text to Speech\",\"item\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create realtime TTS session\",\"item\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session#apireference\",\"headline\":\"Create realtime TTS session\",\"name\":\"Create realtime TTS session\",\"description\":\"Create a short-lived browser-safe token for the realtime text-to-speech WebSocket. This HTTP operation only creates the session. Official SDKs and the CLI prefer the optional query-free direct_websocket_url and fall back to websocket_url; wait for session.ready, and then exchange turn events and binary audio in the selected format. While no turn is active, send session.update with non-empty instructions (up to 1,000 characters) and wait for session.updated; the confirmed instructions apply starting with the next turn. See the Realtime TTS WebSocket guide for complete raw WebSocket, SDK, browser playback, and CLI examples.\",\"url\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.breezeblue.ai/api-reference/text-to-speech/create-realtime-tts-session#webpage\"},\"dateModified\":\"2026-11-17T10:10:59.986Z\",\"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/create-realtime-tts-session.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","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","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","description":"Stream speech and word timestamps as newline-delimited JSON (NDJSON). Each line contains audio, timing updates, or an error. See [Speech timing](https://docs.breezeblue.ai/guides/speech-timing) for stream handling.","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","description":"Enhance a user-provided TTS instruction into clearer model guidance without changing the script or translating the 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":"Create realtime TTS session - 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"]}