- Python
- Python (Async)
- TypeScript
def tts_websocket_speed(client: Cartesia) -> None:
"""Demonstrates changing speed mid-stream using generation_config."""
with client.tts.websocket_connect() as ws:
ctx = ws.context(
model_id="sonic-latest",
voice={"mode": "id", "id": "6ccbfb76-1fc6-48f7-b71d-91ac6298247b"},
output_format={"container": "raw", "encoding": "pcm_s16le", "sample_rate": 44100},
language="en",
)
print("Sending normal speed text...")
ctx.push("I am speaking at a normal pace. ")
print("Sending fast speed text...")
ctx.push("But now I am speaking much faster!", generation_config={"speed": 1.5})
ctx.no_more_inputs()
import datetime
filename = f"tts_speed_{datetime.datetime.now().strftime('%Y%m%d_%H%M%S')}.pcm"
with open(filename, "wb") as f:
for response in ctx.receive():
if response.type == "chunk" and response.audio:
f.write(response.audio)
elif response.type == "error":
print(f"error: {response.message or response.title}")
print(f"Saved audio to {filename}")
print(f"Play with: ffplay -f s16le -ar 44100 {filename}")
async def tts_websocket_speed_async(client: AsyncCartesia) -> None:
"""Async speed changing example."""
async with client.tts.websocket_connect() as ws:
ctx = ws.context(
model_id="sonic-latest",
voice={"mode": "id", "id": "6ccbfb76-1fc6-48f7-b71d-91ac6298247b"},
output_format={"container": "raw", "encoding": "pcm_s16le", "sample_rate": 44100},
language="en",
)
print("Sending normal speed text...")
await ctx.push("I am speaking at a normal pace. ")
print("Sending fast speed text...")
await ctx.push("But now I am speaking much faster!", generation_config={"speed": 1.5})
await ctx.no_more_inputs()
import datetime
filename = f"tts_speed_async_{datetime.datetime.now().strftime('%Y%m%d_%H%M%S')}.pcm"
with open(filename, "wb") as f:
async for response in ctx.receive():
if response.type == "chunk" and response.audio:
f.write(response.audio)
elif response.type == "error":
print(f"error: {response.message or response.title}")
print(f"Saved audio to {filename}")
print(f"Play with: ffplay -f s16le -ar 44100 {filename}")
async function ttsWebsocketSpeed(client: Cartesia): Promise<void> {
const ws = await client.tts.websocket();
ws.on('error', (err) => console.error('WS error:', err.message));
const filename = `tts_speed_${timestamp()}.pcm`;
const file = fs.createWriteStream(filename);
try {
const ctx = ws.context({
model_id: 'sonic-latest',
voice: { mode: 'id', id: '6ccbfb76-1fc6-48f7-b71d-91ac6298247b' },
output_format: { container: 'raw', encoding: 'pcm_f32le', sample_rate: 44100 },
language: 'en',
});
console.log('Sending normal speed text...');
await ctx.push({ transcript: 'I am speaking at a normal pace. ' });
console.log('Sending fast speed text...');
await ctx.push({
transcript: 'But now I am speaking much faster!',
generation_config: { speed: 1.5 },
});
await ctx.no_more_inputs();
for await (const event of ctx.receive()) {
if (event.type === 'chunk') {
if (event.audio) file.write(event.audio);
} else if (event.type === 'error') {
throw new Error(`${event.title}: ${event.message}`);
}
}
console.log(`Saved audio to ${filename}`);
console.log(`Play with: ffplay -f f32le -ar 44100 ${filename}`);
} finally {
file.end();
ws.close();
}
}
Run this example
- Python
- Python (Async)
- TypeScript
git clone --branch v3.2.0 https://github.com/cartesia-ai/cartesia-python
cd cartesia-python
uv sync
CARTESIA_API_KEY=YOUR_KEY uv run examples/examples.py tts_websocket_speed
git clone --branch v3.2.0 https://github.com/cartesia-ai/cartesia-python
cd cartesia-python
uv sync
CARTESIA_API_KEY=YOUR_KEY uv run examples/async_examples.py tts_websocket_speed_async
git clone --branch v3.2.0 https://github.com/cartesia-ai/cartesia-js
cd cartesia-js
pnpm i
CARTESIA_API_KEY=YOUR_KEY pnpm tsn examples/node_examples.ts ttsWebsocketSpeed