Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Izlistaj dostupne glasove

Lekcija 3 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Programatsko otkrivanje glasova
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Odabir pravog glasa
  5. Ugradi odabir glasa u svoju aplikaciju
  6. Najbolje prakse
  7. Ključne točke

Ažurirano 3. studenoga 2026., na temelju referencije xAI Voice API-ja i stranice Text to Speech: odgovor na GET /v1/tts/voices sadrži voice_id, name i language, a xAI nudi 28 ugrađenih glasova. Izvori: Voice API · Text to Speech.

Programatsko otkrivanje glasova

Umjesto da u svoju aplikaciju unaprijed upisuješ popis glasova, xAI API pruža namjensku krajnju točku za dinamičko dohvaćanje dostupnih glasova. Tako ostaješ ažuran kada se dodaju novi glasovi.

GET /v1/tts/voices

Ova krajnja točka vraća popis svih glasova dostupnih za TTS. Ne zahtijeva parametre u tijelu zahtjeva.

curl -X GET "https://api.x.ai/v1/tts/voices" \
  -H "Authorization: Bearer $XAI_API_KEY"

Odgovor je JSON objekt koji sadrži polje voices kao niz. Prema referenciji API-ja, svaki glas ima tri polja: voice_id, ID u malim slovima koji prosljeđuješ u svojim zahtjevima; name, naziv za prikaz; i language, jezični kod koji može biti null.

Oblik odgovora

{
  "voices": [
    {"voice_id": "eve", "name": "…", "language": "…"},
    {"voice_id": "ara", "name": "…", "language": "…"}
  ]
}

Trotočke predstavljaju vrijednosti koje referencija ne navodi kao primjere: ispiši stvarni odgovor jednom prije nego što se osloniš na njega. Ton i slučajevi upotrebe svakog glasa nisu dio ovog odgovora; opisani su na xAI stranici Text to Speech.

GET /v1/tts/voices/{voice_id}

Da bi dobio pojedinosti o određenom glasu, dodaj njegov ID u putanju:

curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
  -H "Authorization: Bearer $XAI_API_KEY"

Ovaj poziv vraća ista polja (voice_id, name, language) samo za traženi glas.

Odabir pravog glasa

xAI nudi 28 ugrađenih glasova (stanje na dan 3. studenoga 2026.) i za većinu njih opisuje za što su najprikladniji. Nekoliko smjernica s te stranice:

  • Obrazovni sadržaj: luna, cosmo ili lumen, navedeni za obrazovanje
  • Korisnička podrška: carina, iris, rigel, celeste, castor, naksh ili aurora, navedeni za podršku
  • Oglašavanje i demonstracije: altair, zenith, perseus, kepler ili lumen, navedeni za oglašavanje; eve, energičan i vedar glas, ostaje zadani glas
  • Naracija i audioknjige: orion, zagan, altair, perseus ili lux
  • Wellness: carina, helios, lux ili liora

Pet izvornih glasova (eve, ara, rex, sal, leo) nema navedene slučajeve upotrebe: xAI ih opisuje samo kao energične i vedre (britanski naglasak), tople i prijateljske, samouvjerene i jasne, glatke i uravnotežene te autoritativne i moćne (britanski naglasak).

Ugradi odabir glasa u svoju aplikaciju

Evo primjera koji dinamički učitava dostupne glasove:

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

Ovaj pristup štiti te od tipfelera u ID-jevima glasova i omogućuje ti da korisnicima ponudiš ažuriran popis.

Najbolje prakse

  • Predmemoriraj popis glasova: krajnja točka /v1/tts/voices se ne mijenja često, pa je jedan poziv pri pokretanju aplikacije dovoljan
  • Ponudi pregled: dopusti korisnicima da poslušaju uzorak svakog glasa prije odabira
  • Spremi preferenciju: kada korisnik odabere glas, spremi taj izbor za buduće sesije
  • Testiraj na ciljnom jeziku: glas koji zvuči sjajno na engleskom može zvučati drugačije na drugom jeziku. Uvijek testiraj u jeziku svoje aplikacije

Ključne točke

  • GET /v1/tts/voices izlistava sve dostupne glasove s njihovim metapodacima
  • GET /v1/tts/voices/{voice_id} daje pojedinosti o određenom glasu
  • Dostupno je 28 ugrađenih glasova; njihov ton i slučajevi upotrebe opisani su na xAI stranici Text to Speech
  • Odgovor na GET /v1/tts/voices daje voice_id, name i language za svaki glas
  • Učitavaj glasove dinamički umjesto da ih unaprijed upisuješ u kod