Výpis dostupných hlasů
Na této stránce
Aktualizováno 3. listopadu 2026 na základě reference xAI Voice API a stránky Text to Speech: odpověď z
GET /v1/tts/voicesobsahujevoice_id,namealanguagea xAI nabízí 28 vestavěných hlasů. Zdroje: Voice API · Text to Speech.
Programové zjišťování hlasů
Místo toho, abys seznam hlasů ve své aplikaci natvrdo zakódoval, poskytuje API xAI vyhrazený koncový bod pro dynamické načítání dostupných hlasů. Díky tomu budeš mít vždy aktuální informace, když přibudou nové hlasy.
GET /v1/tts/voices
Tento koncový bod vrací seznam všech hlasů dostupných pro TTS. Nevyžaduje žádné parametry v těle požadavku.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Odpovědí je objekt JSON obsahující pole voices. Podle reference API má každý hlas tři pole: voice_id (ID v malých písmenech, které předáš ve svých požadavcích), name (zobrazovaný název) a language (kód jazyka, který může být null).
Struktura odpovědi
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Tečky zastupují hodnoty, které reference neuvádí jako příklady: před tím, než se na ně spolehneš, si vytiskni skutečnou odpověď. Tón a případy použití jednotlivých hlasů nejsou v této odpovědi zahrnuty; jsou popsány na stránce xAI Text to Speech.
GET /v1/tts/voices/{voice_id}
Chceš-li získat podrobnosti o konkrétním hlase, přidej jeho ID do cesty:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Tento volání vrátí stejná pole (voice_id, name, language) pouze pro požadovaný hlas.
Výběr správného hlasu
xAI nabízí 28 vestavěných hlasů (k 3. listopadu 2026) a u většiny z nich popisuje, k čemu se nejlépe hodí. Několik tipů z této stránky:
- Vzdělávací obsah:
luna,cosmonebolumen, uvedeny pro vzdělávání - Zákaznická podpora:
carina,iris,rigel,celeste,castor,nakshneboaurora, uvedeny pro podporu - Reklama a dema:
altair,zenith,perseus,keplernebolumen, uvedeny pro reklamu;eve, energický a optimistický, zůstává výchozím hlasem - Vyprávění a audioknihy:
orion,zagan,altair,perseusnebolux - Wellness:
carina,helios,luxneboliora
Pět původních hlasů (eve, ara, rex, sal, leo) nemá uvedeny žádné konkrétní případy použití: xAI je pouze popisuje jako energické a optimistické (britský přízvuk), vřelé a přátelské, sebevědomé a jasné, hladké a vyvážené a autoritativní a mocné (britský přízvuk).
Implementace výběru hlasu do aplikace
Zde je příklad, který dynamicky načítá 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 přístup tě ochrání před překlepy v ID hlasů a umožní ti nabídnout uživatelům aktuální seznam.
Doporučené postupy
- Ukládej seznam hlasů do mezipaměti: koncový bod
/v1/tts/voicesse často nemění, takže stačí jedno volání při spuštění aplikace - Nabídni náhled: umožni uživatelům poslechnout si ukázku každého hlasu, než si ho vyberou
- Ulož preferenci: jakmile si uživatel vybere hlas, ulož tuto volbu pro budoucí relace
- Testuj v cílovém jazyce: hlas, který zní skvěle v angličtině, může v jiném jazyce znít jinak. Vždy testuj v jazyce své aplikace
Klíčové poznatky
GET /v1/tts/voicesvypíše všechny dostupné hlasy s jejich metadatyGET /v1/tts/voices/{voice_id}poskytne podrobnosti o konkrétním hlase- K dispozici je 28 vestavěných hlasů; jejich tón a případy použití jsou popsány na stránce xAI Text to Speech
- Odpověď z
GET /v1/tts/voicesposkytuje pro každý hlasvoice_id,namealanguage - Načítej hlasy dynamicky, místo abys je natvrdo zakódoval