Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Lista tillgängliga röster

Lektion 3 av 14 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Upptäck röster programmatiskt
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Välj rätt röst
  5. Bygg in röstval i din app
  6. Bästa praxis
  7. Viktiga punkter

Uppdaterat den 3 november 2026, baserat på xAI Voice API-referensen och sidan Text to Speech: svaret från GET /v1/tts/voices innehåller voice_id, name och language, och xAI erbjuder 28 inbyggda röster. Källor: Voice API · Text to Speech.

Upptäck röster programmatiskt

Istället för att hårdkoda listan över röster i din app, tillhandahåller xAI API:et en dedikerad slutpunkt för att hämta tillgängliga röster dynamiskt. På så sätt håller du dig uppdaterad när nya röster läggs till.

GET /v1/tts/voices

Denna slutpunkt returnerar listan över alla röster som finns tillgängliga för TTS. Den kräver inga parametrar i begärandekroppen.

curl -X GET "https://api.x.ai/v1/tts/voices" \
  -H "Authorization: Bearer $XAI_API_KEY"

Svaret är ett JSON-objekt som innehåller en voices-array. Enligt API-referensen har varje röst tre fält: voice_id, det gemena ID:t som skickas i dina begäranden; name, ett visningsnamn; och language, en språkkod som kan vara null.

Svarsstruktur

{
  "voices": [
    {"voice_id": "eve", "name": "…", "language": "…"},
    {"voice_id": "ara", "name": "…", "language": "…"}
  ]
}

Ellipsarna står för värden som referensen inte ger som exempel: skriv ut det verkliga svaret en gång innan du förlitar dig på det. Varje rösts tonfall och användningsområden finns inte med i detta svar; de beskrivs på xAI:s sida Text to Speech.

GET /v1/tts/voices/{voice_id}

För att hämta detaljer om en specifik röst lägger du till dess ID i sökvägen:

curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
  -H "Authorization: Bearer $XAI_API_KEY"

Detta anrop returnerar samma fält (voice_id, name, language) men endast för den begärda rösten.

Välj rätt röst

xAI erbjuder 28 inbyggda röster (per den 3 november 2026) och för de flesta av dem beskrivs vad de passar bäst för. Här är några tips från den sidan:

  • Utbildningsinnehåll: luna, cosmo eller lumen, listade för utbildning
  • Kundsupport: carina, iris, rigel, celeste, castor, naksh eller aurora, listade för support
  • Reklam och demos: altair, zenith, perseus, kepler eller lumen, listade för reklam; eve, energisk och uppåt, förblir standardrösten
  • Berättande och ljudböcker: orion, zagan, altair, perseus eller lux
  • Hälsa och välbefinnande: carina, helios, lux eller liora

De fem ursprungliga rösterna (eve, ara, rex, sal, leo) har inga listade användningsområden: xAI beskriver dem endast som energiska och uppåt (brittisk accent), varma och vänliga, självsäkra och tydliga, mjuka och balanserade, samt auktoritära och kraftfulla (brittisk accent).

Bygg in röstval i din app

Här är ett exempel som laddar tillgängliga röster dynamiskt:

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

Detta tillvägagångssätt skyddar dig mot stavfel i röst-ID:n och låter dig erbjuda dina användare en uppdaterad lista.

Bästa praxis

  • Cachelagra röstlistan: slutpunkten /v1/tts/voices ändras inte ofta, så ett anrop när din app startar räcker
  • Erbjud förhandslyssning: låt dina användare lyssna på ett prov av varje röst innan de väljer
  • Spara preferensen: när en användare har valt en röst, spara valet för framtida sessioner
  • Testa på målspråket: en röst som låter bra på engelska kan låta annorlunda på ett annat språk. Testa alltid på ditt apps språk

Viktiga punkter

  • GET /v1/tts/voices listar alla tillgängliga röster med deras metadata
  • GET /v1/tts/voices/{voice_id} ger detaljer om en specifik röst
  • 28 inbyggda röster finns tillgängliga; deras tonfall och användningsområden beskrivs på xAI:s sida Text to Speech
  • Svaret från GET /v1/tts/voices ger voice_id, name och language för varje röst
  • Ladda röster dynamiskt istället för att hårdkoda dem