Lista tillgängliga röster
På denna sida
Uppdaterat den 3 november 2026, baserat på xAI Voice API-referensen och sidan Text to Speech: svaret från
GET /v1/tts/voicesinnehållervoice_id,nameochlanguage, 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,cosmoellerlumen, listade för utbildning - Kundsupport:
carina,iris,rigel,celeste,castor,nakshelleraurora, listade för support - Reklam och demos:
altair,zenith,perseus,keplerellerlumen, listade för reklam;eve, energisk och uppåt, förblir standardrösten - Berättande och ljudböcker:
orion,zagan,altair,perseusellerlux - Hälsa och välbefinnande:
carina,helios,luxellerliora
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/voiceslistar alla tillgängliga röster med deras metadataGET /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/voicesgervoice_id,nameochlanguageför varje röst - Ladda röster dynamiskt istället för att hårdkoda dem