Liste over tilgængelige stemmer
På denne side
Opdateret 3. november 2026 baseret på xAI Voice API-referencen og siden Text to Speech: Svaret fra
GET /v1/tts/voicesindeholdervoice_id,nameoglanguage, og xAI tilbyder 28 indbyggede stemmer. Kilder: Voice API · Text to Speech.
Opdag stemmer programmatisk
I stedet for at hardkode listen over stemmer i din app, tilbyder xAI API’en et dedikeret endpoint til dynamisk at hente de tilgængelige stemmer. På den måde holder du dig opdateret, når nye stemmer tilføjes.
GET /v1/tts/voices
Dette endpoint returnerer listen over alle stemmer, der er tilgængelige til TTS. Det kræver ingen parametre i request-bodyen.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Svaret er et JSON-objekt, der indeholder et voices-array. Ifølge API-referencen har hver stemme tre felter: voice_id, det lille ID, du skal sende i dine requests; name, et visningsnavn; og language, en sprogkode, der kan være null.
Responsens struktur
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Ellipserne står for værdier, som referencen ikke giver som eksempler: Udprint det faktiske svar én gang, før du baserer din logik på det. Hver stemmes tone og anvendelsesområder fremgår ikke af dette svar; de er beskrevet på xAI-siden Text to Speech.
GET /v1/tts/voices/{voice_id}
For at hente detaljer om en specifik stemme skal du tilføje dens ID til stien:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Dette kald returnerer de samme felter (voice_id, name, language) kun for den anmodede stemme.
Vælg den rigtige stemme
xAI tilbyder 28 indbyggede stemmer (pr. 3. november 2026), og for de fleste af dem beskrives det, hvad de egner sig bedst til. Her er nogle pointer fra den side:
- Uddannelsesindhold:
luna,cosmoellerlumen, listet under uddannelse - Kundesupport:
carina,iris,rigel,celeste,castor,nakshelleraurora, listet under support - Reklame og demoer:
altair,zenith,perseus,keplerellerlumen, listet under reklame;eve, der er energisk og munter, forbliver standardstemmen - Oplæsning og lydbøger:
orion,zagan,altair,perseusellerlux - Trivsel:
carina,helios,luxellerliora
De fem oprindelige stemmer (eve, ara, rex, sal, leo) har ingen listede anvendelsesområder: xAI beskriver dem blot som energiske og muntre (britisk accent), varme og venlige, selvsikre og klare, glatte og afbalancerede samt autoritative og kraftfulde (britisk accent).
Indbyg valg af stemme i din app
Her er et eksempel, der indlæser de tilgængelige stemmer dynamisk:
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
Denne tilgang beskytter dig mod tastefejl i stemme-ID’er og giver dig mulighed for at tilbyde dine brugere en opdateret liste.
Bedste praksis
- Cacheliste over stemmer: Endpointet
/v1/tts/voicesændrer sig ikke ofte, så ét kald, når din app starter, er nok - Tilbyd forhåndsvisning: Lad dine brugere lytte til en prøve af hver stemme, før de vælger
- Gem præferencen: Når en bruger har valgt en stemme, så gem valget til fremtidige sessioner
- Test på målsproget: En stemme, der lyder fantastisk på engelsk, kan lyde anderledes på et andet sprog. Test altid på dit apps sprog
Vigtige pointer
GET /v1/tts/voiceslister alle tilgængelige stemmer med deres metadataGET /v1/tts/voices/{voice_id}giver detaljer om en specifik stemme- Der er 28 indbyggede stemmer tilgængelige; deres tone og anvendelsesområder er beskrevet på xAI-siden Text to Speech
- Svaret fra
GET /v1/tts/voicesgivervoice_id,nameoglanguagefor hver stemme - Indlæs stemmer dynamisk i stedet for at hardkode dem