- Python
- Python (Async)
- TypeScript
def tts_generate_to_file(client: Cartesia) -> None:
"""Use generate() and write_to_file() to write a wav file."""
response = client.tts.generate(
model_id="sonic-latest",
transcript="Hello, world!",
voice={"mode": "id", "id": "6ccbfb76-1fc6-48f7-b71d-91ac6298247b"},
output_format={"container": "wav", "encoding": "pcm_s16le", "sample_rate": 44100},
language="en",
)
response.write_to_file("output.wav")
print(f"Saved audio to output.wav")
print(f"Play with: ffplay -f wav output.wav")
async def tts_generate_async(client: AsyncCartesia) -> None:
"""Async TTS generation to file."""
response = await client.tts.generate(
model_id="sonic-latest",
transcript="Hello, world!",
voice={"mode": "id", "id": "6ccbfb76-1fc6-48f7-b71d-91ac6298247b"},
output_format={"container": "wav", "encoding": "pcm_s16le", "sample_rate": 44100},
language="en",
)
await response.write_to_file("output_async.wav")
print("Saved audio to output_async.wav")
print("Play with: ffplay -f wav output_async.wav")
async function ttsGenerateToFile(client: Cartesia): Promise<void> {
const response = await client.tts.generate({
model_id: 'sonic-latest',
transcript: 'Hello, world!',
voice: { mode: 'id', id: '6ccbfb76-1fc6-48f7-b71d-91ac6298247b' },
output_format: { container: 'wav', encoding: 'pcm_f32le', sample_rate: 44100 },
language: 'en',
});
const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync('output.wav', buffer);
console.log('Saved audio to output.wav');
console.log('Play with: ffplay -f wav output.wav');
}
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_generate_to_file
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_generate_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 ttsGenerateToFile