Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Zoznam dostupných hlasov

Lekcia 3 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Programové vyhľadanie hlasov
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Výber správneho hlasu
  5. Implementácia výberu hlasu do tvojej aplikácie
  6. Osvedčené postupy
  7. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe referencie xAI Voice API a stránky Text to Speech: odpoveď z GET /v1/tts/voices obsahuje voice_id, name a language a 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, cosmo alebo lumen, uvedené pre vzdelávanie
  • Zákaznícka podpora: carina, iris, rigel, celeste, castor, naksh alebo aurora, uvedené pre podporu
  • Reklama a ukážky: altair, zenith, perseus, kepler alebo lumen, uvedené pre reklamu; eve, energický a optimistický, zostáva predvoleným hlasom
  • Rozprávanie a audioknihy: orion, zagan, altair, perseus alebo lux
  • Wellness: carina, helios, lux alebo liora

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/voices sa č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/voices vypíše všetky dostupné hlasy s ich metadátami
  • GET /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/voices poskytuje pre každý hlas voice_id, name a language
  • Načítavaj hlasy dynamicky namiesto ich natvrdo zakódovania