curl \
--request POST \
--url "https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp/stream/with-timestamps" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"text": "Hello world.",
"model_id": "breeze-tts-2-multilingual",
"language_code": "en",
"timestamp_mode": "chunk"
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
with client.text_to_speech.stream_with_timestamps("voc_example", text="Hello world.") as stream:
for chunk in stream:
print(chunk["word_timestamps"])import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const stream = await client.textToSpeech.streamWithTimestamps("voc_example", { text: "Hello world." });
for await (const chunk of stream) console.log(chunk.wordTimestamps);{
"audio_base64": "<string>",
"word_timestamps": [
{
"index": 1,
"word": "<string>",
"start": 1,
"end": 1
}
]
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Stream speech with word timestamps
Stream speech and word timestamps as newline-delimited JSON (NDJSON). Each line contains audio, timing updates, or an error. See Speech timing for stream handling.
curl \
--request POST \
--url "https://api.breeze.blue/v1/text-to-speech/voc_xeh3w54cqvnp/stream/with-timestamps" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"text": "Hello world.",
"model_id": "breeze-tts-2-multilingual",
"language_code": "en",
"timestamp_mode": "chunk"
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
with client.text_to_speech.stream_with_timestamps("voc_example", text="Hello world.") as stream:
for chunk in stream:
print(chunk["word_timestamps"])import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const stream = await client.textToSpeech.streamWithTimestamps("voc_example", { text: "Hello world." });
for await (const chunk of stream) console.log(chunk.wordTimestamps);{
"audio_base64": "<string>",
"word_timestamps": [
{
"index": 1,
"word": "<string>",
"start": 1,
"end": 1
}
]
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Continue building
Write instructions
Speech timing
Convert with timestamps
Output formats
Authorizations
Breeze Developer API key.
Path Parameters
Voice ID. See List voices.
Query Parameters
Audio encoding: pcm, mp3, or wav. Default: pcm. Decode audio_base64 before playing. See Output formats.
Body
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.
1Model ID for speech generation. Selected automatically when omitted. See List models.
1 - 120ISO 639-1 two-letter language code supported by the selected model. See supported language codes.
2^[A-Za-z]{2}$Performance instructions, written in the same language as the input text. See Expressive controls, Voice instruction prompting.
Optional per-request voice settings override. See Voice settings.
Show child attributes
Show child attributes
chunk, lookahead Response
NDJSON; each line is a speech timing chunk. A stream error instead contains an error object with code and message.
Base64 audio bytes; may be empty for metadata-only updates. See Decode audio and timing.
See Speech timing.
Show child attributes
Show child attributes

