Text-to-Speech Guide
Generate natural-sounding speech from text using SonicVox's AI voices.
Quick Start
- Navigate to Text-to-Speech in the sidebar
- Enter your text in the editor
- Select a voice from the dropdown
- Click Generate Speech
- Download or preview your audio
Voice Selection
Built-in Voices
SonicVox includes professional pre-trained voices. The studio's language picker offers Auto-detect plus 24 languages:
- English, Chinese, Cantonese, Spanish, French, German, Italian, Portuguese, Russian
- Japanese, Korean, Urdu, Hindi, Arabic, Dutch, Polish, Turkish
- Greek, Hungarian, Finnish, Swedish, Danish, Indonesian, Vietnamese
There are also Force All variants for Chinese, Japanese, Korean, and Cantonese, for text that mixes scripts.
Coverage is per engine, not global, and the studio routes your request to an engine that speaks the language you picked: Multilingual covers 30+ languages, Studio 23, Expressive 16, Signature 10, and Classic 5 (English, Chinese, Japanese, Korean, Cantonese).
Cloned Voices
Use your own cloned voices for personalized output. See the Voice Cloning Guide.
Text Formatting
Paragraphs
One request produces one audio clip — paragraphs are not split into separate files. Line breaks and punctuation still shape pacing within that clip.
Pauses
SSML authoring was removed from the studio, so <break> and <emphasis> tags are not the way to control delivery. Type a pause token directly into your text instead:
[pause:1.5s]- pause for 1.5 seconds[pause:500ms]- pause in milliseconds[pause],[short pause],[long pause]- shorthand
Pause lengths are clamped to 50ms - 10s.
Settings
Speed and Pitch live in the Global Prosody panel, behind a toggle that is off by default — leave it off and your audio renders at 1.0x and 0 semitones no matter where the sliders sit.
| Setting | Description | Range |
|---|---|---|
| Speed | Synthesis rate — how fast the voice actually speaks, baked into the generated audio (not a playback control) | 50% - 200% (0.5x - 2x) |
| Pitch | Pitch shift in semitones | -12st to +12st |
There is no Volume control on the Text-to-Speech page. The API exposes a volume gain multiplier (0 - 2) if you need one.
Best Practices
- Keep paragraphs short - 2-3 sentences each for natural flow
- Use punctuation - Commas and periods affect pacing
- Preview before downloading - Check pronunciation
- Spell out numbers - "twenty-three" vs "23" for clarity
Output Formats
In the app, Download is available immediately after generation and gives you an MP3.
Over the API, output_format selects the container/codec:
mp3wav- the default when you omit the fieldpcm_16000pcm_24000opus
API Access
For programmatic access, use the TTS API. Full verified request/response examples live at the Text to Speech API reference.
POST /api/v1/text-to-speech
sv-api-key: YOUR_API_KEY
Content-Type: application/json
{
"text": "Hello world",
"voice_id": "your_voice_id",
"output_format": "mp3"
}
The sv-api-key header is required (x-api-key and Authorization: Bearer are accepted too). Omit voice_id to fall back to your account default voice.
