De beschikbare stemmen opsommen
Op deze pagina
Bijgewerkt op 3 november 2026, gebaseerd op de xAI Voice API-referentie en de pagina Text to Speech: het antwoord van
GET /v1/tts/voicesbevatvoice_id,nameenlanguage, en xAI biedt 28 ingebouwde stemmen. Bronnen: Voice API · Text to Speech.
Stemmen programmatisch ontdekken
In plaats van de lijst met stemmen hard-coded in uw applicatie op te nemen, biedt de xAI API een specifiek eindpunt om de beschikbare stemmen dynamisch op te halen. Zo blijft u up-to-date wanneer er nieuwe stemmen worden toegevoegd.
GET /v1/tts/voices
Dit eindpunt retourneert de lijst van alle voor TTS beschikbare stemmen. Er zijn geen parameters nodig in de request body.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Het antwoord is een JSON-object dat een voices-array bevat. Volgens de API-referentie heeft elke stem drie velden: voice_id, de ID in kleine letters die u in uw requests moet gebruiken; name, een weergavenaam; en language, een taalcode die null kan zijn.
Vorm van het antwoord
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
De ellipsen staan voor waarden die de referentie niet als voorbeeld geeft: print het echte antwoord eenmaal af voordat u erop vertrouwt. De toon en use cases van elke stem staan niet in dit antwoord; deze worden beschreven op de xAI-pagina Text to Speech.
GET /v1/tts/voices/{voice_id}
Om de details van een specifieke stem op te halen, voegt u de ID toe aan het pad:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Deze call retourneert dezelfde velden (voice_id, name, language) maar dan alleen voor de gevraagde stem.
De juiste stem kiezen
xAI biedt 28 ingebouwde stemmen (per 3 november 2026) en beschrijft voor de meeste waarvoor ze het meest geschikt zijn. Enkele aanwijzingen van die pagina:
- Educatieve content:
luna,cosmooflumen, vermeld voor onderwijs - Klantenservice:
carina,iris,rigel,celeste,castor,nakshofaurora, vermeld voor support - Reclame en demo’s:
altair,zenith,perseus,kepleroflumen, vermeld voor reclame;eve, energiek en optimistisch, blijft de standaardstem - Vertelling en audioboeken:
orion,zagan,altair,perseusoflux - Welzijn:
carina,helios,luxofliora
De vijf oorspronkelijke stemmen (eve, ara, rex, sal, leo) hebben geen vermelde use cases: xAI beschrijft ze alleen als energiek en optimistisch (Brits accent), warm en vriendelijk, zelfverzekerd en helder, soepel en gebalanceerd, en autoritair en krachtig (Brits accent).
Stemselectie inbouwen in uw app
Hier is een voorbeeld dat de beschikbare stemmen dynamisch laadt:
import requests
def get_available_voices(api_key):
response = requests.get(
"https://api.x.ai/v1/tts/voices",
headers={"Authorization": f"Bearer {api_key}"}
)
response.raise_for_status()
return response.json()["voices"]
def synthesize(api_key, text, voice_id="eve", language="en"):
voices = get_available_voices(api_key)
valid_ids = [v["voice_id"] for v in voices]
if voice_id.lower() not in valid_ids:
raise ValueError(f"Unknown voice '{voice_id}'. Available: {valid_ids}")
response = requests.post(
"https://api.x.ai/v1/tts",
headers={"Authorization": f"Bearer {api_key}"},
json={"text": text, "voice_id": voice_id, "language": language}
)
return response.content
Deze aanpak beschermt u tegen typefouten in stem-ID’s en stelt u in staat uw gebruikers een actuele lijst aan te bieden.
Best practices
- Cache de stemmenlijst: het
/v1/tts/voices-eindpunt verandert niet vaak, dus één call bij het opstarten van uw app volstaat - Bied een voorvertoning: laat uw gebruikers een sample van elke stem beluisteren voordat ze kiezen
- Sla de voorkeur op: zodra een gebruiker een stem heeft gekozen, slaat u de keuze op voor toekomstige sessies
- Test in de doeltaal: een stem die geweldig klinkt in het Engels, kan anders klinken in een andere taal. Test altijd in de taal van uw app
Belangrijkste punten
GET /v1/tts/voicessomt alle beschikbare stemmen op met hun metadataGET /v1/tts/voices/{voice_id}geeft de details van een specifieke stem- Er zijn 28 ingebouwde stemmen beschikbaar; hun toon en use cases worden beschreven op de xAI-pagina Text to Speech
- Het antwoord van
GET /v1/tts/voicesgeeft voor elke stemvoice_id,nameenlanguage - Laad stemmen dynamisch in plaats van ze hard-coded vast te leggen