1. Install and set your key
2. Generate speech
Pick a voice
voice_id takes a catalog voice id (a number) or the id of a voice you cloned. List what your key can use:
Direct the delivery
Directions go inline in the text:- Emotion and delivery: a leading bracket per segment, e.g.
[whispering, tense]. - Non-verbal sounds:
[laugh],[sigh],[breathe],[chuckle],[gasp]and more. - Pauses:
<break time="500ms"/>(up to 10 s each, 20 per request). - Pronunciation: IPA between slashes, e.g.
Worcester /ˈwʊstər/.
Tips
speedruns from 0.25 to 4.0 (default 1.0).audio_format/audioFormatsetsmp3,wavorogg.- For a “listen to this page” button, call TTS from a server route so your API key never reaches the browser, then return
output_urlto the client. - Word-level timestamps for read-along UIs and designing a voice from a text description are covered in the Text to Speech reference.
From an AI agent
On the full MCP endpoint (https://mcp.audiopod.ai, see AudioPod for AI agents) ask: “Read this paragraph aloud in a calm voice: …”. The agent calls text_to_speech with text and, optionally, voice_id, language and speed.