Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De beschikbare stemmen opsommen

Les 3 van 14 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Stemmen programmatisch ontdekken
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. De juiste stem kiezen
  5. Stemselectie inbouwen in uw app
  6. Best practices
  7. Belangrijkste punten

Bijgewerkt op 3 november 2026, gebaseerd op de xAI Voice API-referentie en de pagina Text to Speech: het antwoord van GET /v1/tts/voices bevat voice_id, name en language, 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, cosmo of lumen, vermeld voor onderwijs
  • Klantenservice: carina, iris, rigel, celeste, castor, naksh of aurora, vermeld voor support
  • Reclame en demo’s: altair, zenith, perseus, kepler of lumen, vermeld voor reclame; eve, energiek en optimistisch, blijft de standaardstem
  • Vertelling en audioboeken: orion, zagan, altair, perseus of lux
  • Welzijn: carina, helios, lux of liora

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/voices somt alle beschikbare stemmen op met hun metadata
  • GET /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/voices geeft voor elke stem voice_id, name en language
  • Laad stemmen dynamisch in plaats van ze hard-coded vast te leggen