| text |
Text to synthesize (max 15,000 characters). Supports inline speech tags such as [pause], [laugh], and wrapping tags like …. |
string |
Yes |
- |
| language |
BCP-47 language code, or auto for automatic detection. |
string |
Yes |
auto, en, ar-EG, ar-SA, ar-AE, bn, zh, fr, de, hi, id, it, ja, ko, pt-BR, pt-PT, ru, es-MX, es-ES, tr, vi |
| voice_id |
Voice ID for synthesis. Built-in voices are listed below (26 total, case-insensitive). Custom voice IDs from your xAI voice library are also accepted. |
string |
No |
- |
| bit_rate |
MP3 bit rate in bps. Only applied when codec is mp3. Default 128000. |
integer |
No |
32000, 64000, 96000, 128000, 192000 |
| codec |
Audio codec. Default mp3. |
string |
No |
mp3, wav, pcm, mulaw, alaw |
| optimize_streaming_latency |
Latency vs quality trade-off: 0 best quality (default), 1 lower first-byte latency, 2 lowest first-byte latency. |
integer |
No |
0, 1, 2 |
| sample_rate |
Sample rate in Hz. Default 24000. |
integer |
No |
8000, 16000, 22050, 24000, 44100, 48000 |
| speed |
Speech speed multiplier. Range 0.7–1.5. Default 1.0. |
number |
No |
- |
| text_normalization |
When true, normalize written-form text (numbers, abbreviations) before synthesis. |
boolean |
No |
true, false |
