Use custom voice in xAI Text to Speech API
Pass the custom voice_id as the 'voice' query parameter in TTS API calls.
GET /v1/tts?voice=[[CUSTOM_VOICE_ID]]&text=Hello+world
Language
bash
Explanation
To use a custom voice, simply replace the built-in voice identifier with your custom voice_id in the 'voice' query parameter of the TTS API request.
What it does and when to use it
This example shows how to integrate a custom voice into Text to Speech API calls. The custom voice ID is passed as a query parameter, making it interchangeable with built-in voices.
Why it works
The API is designed to accept custom voice IDs in the same parameter as built-in voices, simplifying integration and allowing seamless switching between voice options.
Sources and credit
- Custom Voices ↗xAI · xAI Docs: Guides · Aug 3, 2026 · quoted as shared
First seen on Subvolts Aug 3, 2026. Updated Sep 11, 2026. Spotted a problem? Tell us.
Where it shows up
- Custom VoicesxAI · xAI Docs: Guides · Aug 3, 2026
Terms used
Related in the PlaybookPlaybook →
The Playbook: reusable how-tos, prompts, configs and tips pulled out of the news.
- Code snippetBuild real-time speech-to-speech voice agents over WebSocketsDevelop low-latency, real-time voice agents using WebSockets for interactive conversations with tool use. · 10 min
- Code snippetClone a voice for custom TTS and speech-to-speech applicationsClone a custom voice from a short reference clip for use in TTS and real-time speech-to-speech APIs. · 10 min
- Code snippetGenerate speech with expressive multilingual voices and tagsCreate spoken audio with diverse voices, inline speech tags for emotion, and various output formats. · 5 min
- Code snippetSecurely connect client-side apps using Ephemeral TokensUse Ephemeral Tokens for secure, keyless connections from client-side applications to xAI Voice APIs. · 5 min
- Code snippetTranscribe audio in 25 languages with batch or streaming modesTranscribe audio files or streams into text across 25 languages, supporting batch and real-time processing. · 5 min
- Code snippetSend ephemeral token in sec-websocket-protocol headerAdd the ephemeral token with a specific prefix to the sec-websocket-protocol header for browser-based API calls. · 5 min
Questions people ask
- Which AI tools does this work with?
- The sources used it with Grok.
- Where did this come from?
- xAI (xAI Docs: Guides). Subvolts collected, normalized and credited it; the link above opens the original.