Zoznam dostupných hlasov
Na tejto strane
Aktualizované 3. novembra 2026 na základe referencie xAI Voice API a stránky Text to Speech: odpoveď z
GET /v1/tts/voicesobsahujevoice_id,namealanguagea xAI ponúka 28 vstavaných hlasov. Zdroje: Voice API · Text to Speech.
Programové vyhľadanie hlasov
Namiesto natvrdo zakódovaného zoznamu hlasov vo tvojej aplikácii ti API xAI poskytuje vyhradený koncový bod na dynamické získavanie dostupných hlasov. Týmto spôsobom zostaneš aktuálny aj pri pridávaní nových hlasov.
GET /v1/tts/voices
Tento koncový bod vráti zoznam všetkých hlasov dostupných pre TTS. Nevyžaduje žiadne parametre v tele požiadavky.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Odpoveďou je objekt JSON obsahujúci pole voices. Podľa referencie API má každý hlas tri polia: voice_id (identifikátor v malých písmenách, ktorý odovzdáš vo svojich požiadavkách), name (zobrazovaný názov) a language (kód jazyka, ktorý môže byť null).
Štruktúra odpovede
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Tri bodky zastupujú hodnoty, ktoré referencia neuvádza ako príklady: pred tým, než sa na ne budeš spoliehať, si vytlač skutočnú odpoveď. Tón a prípady použitia jednotlivých hlasov nie sú v tejto odpovedi zahrnuté; sú opísané na stránke xAI Text to Speech.
GET /v1/tts/voices/{voice_id}
Ak chceš získať podrobnosti o konkrétnom hlase, pridaj jeho ID do cesty:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Tento volanie vráti rovnaké polia (voice_id, name, language) len pre požadovaný hlas.
Výber správneho hlasu
xAI ponúka 28 vstavaných hlasov (k 3. novembru 2026) a pre väčšinu z nich opisuje, na čo sa najlepšie hodia. Niekoľko tipov z tejto stránky:
- Vzdelávací obsah:
luna,cosmoalebolumen, uvedené pre vzdelávanie - Zákaznícka podpora:
carina,iris,rigel,celeste,castor,nakshaleboaurora, uvedené pre podporu - Reklama a ukážky:
altair,zenith,perseus,kepleralebolumen, uvedené pre reklamu;eve, energický a optimistický, zostáva predvoleným hlasom - Rozprávanie a audioknihy:
orion,zagan,altair,perseusalebolux - Wellness:
carina,helios,luxaleboliora
Päť pôvodných hlasov (eve, ara, rex, sal, leo) nemá uvedené žiadne konkrétne prípady použitia: xAI ich opisuje len ako energické a optimistické (britský prízvuk), teplé a priateľské, sebavedomé a jasné, hladké a vyvážené a autoritatívne a mocné (britský prízvuk).
Implementácia výberu hlasu do tvojej aplikácie
Tu je príklad, ktorý dynamicky načíta dostupné hlasy:
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
Tento prístup ťa ochráni pred preklepmi v ID hlasov a umožní ti ponúknuť používateľom aktuálny zoznam.
Osvedčené postupy
- Ukladaj zoznam hlasov do vyrovnávacej pamäte: koncový bod
/v1/tts/voicessa často nemení, takže stačí jedno volanie pri štarte aplikácie - Ponúkni ukážku: umožni používateľom vypočuť si vzorku každého hlasu pred výberom
- Ulož preferenciu: keď si používateľ vyberie hlas, ulož túto voľbu pre budúce relácie
- Testuj v cieľovom jazyku: hlas, ktorý znie skvele v angličtine, môže v inom jazyku znieť inak. Vždy testuj v jazyku tvojej aplikácie
Kľúčové poznatky
GET /v1/tts/voicesvypíše všetky dostupné hlasy s ich metadátamiGET /v1/tts/voices/{voice_id}poskytne podrobnosti o konkrétnom hlase- K dispozícii je 28 vstavaných hlasov; ich tón a prípady použitia sú opísané na stránke xAI Text to Speech
- Odpoveď z
GET /v1/tts/voicesposkytuje pre každý hlasvoice_id,namealanguage - Načítavaj hlasy dynamicky namiesto ich natvrdo zakódovania