Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Výpis dostupných hlasů

Lekce 3 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Programové zjišťování hlasů
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Výběr správného hlasu
  5. Implementace výběru hlasu do aplikace
  6. Doporučené postupy
  7. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě reference xAI Voice API a stránky Text to Speech: odpověď z GET /v1/tts/voices obsahuje voice_id, name a language a 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, cosmo nebo lumen, uvedeny pro vzdělávání
  • Zákaznická podpora: carina, iris, rigel, celeste, castor, naksh nebo aurora, uvedeny pro podporu
  • Reklama a dema: altair, zenith, perseus, kepler nebo lumen, uvedeny pro reklamu; eve, energický a optimistický, zůstává výchozím hlasem
  • Vyprávění a audioknihy: orion, zagan, altair, perseus nebo lux
  • Wellness: carina, helios, lux nebo liora

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/voices se č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/voices vypíše všechny dostupné hlasy s jejich metadaty
  • GET /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/voices poskytuje pro každý hlas voice_id, name a language
  • Načítej hlasy dynamicky, místo abys je natvrdo zakódoval