Izlistaj dostupne glasove
Na ovoj stranici
Ažurirano 3. studenoga 2026., na temelju referencije xAI Voice API-ja i stranice Text to Speech: odgovor na
GET /v1/tts/voicessadrživoice_id,nameilanguage, 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,cosmoililumen, navedeni za obrazovanje - Korisnička podrška:
carina,iris,rigel,celeste,castor,nakshiliaurora, navedeni za podršku - Oglašavanje i demonstracije:
altair,zenith,perseus,keplerililumen, navedeni za oglašavanje;eve, energičan i vedar glas, ostaje zadani glas - Naracija i audioknjige:
orion,zagan,altair,perseusililux - Wellness:
carina,helios,luxililiora
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/voicesse 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/voicesizlistava sve dostupne glasove s njihovim metapodacimaGET /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/voicesdajevoice_id,nameilanguageza svaki glas - Učitavaj glasove dinamički umjesto da ih unaprijed upisuješ u kod