Izpiši razpoložljive glasove
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi referenčne dokumentacije za xAI Voice API in strani Text to Speech: odgovor na klic
GET /v1/tts/voicesvsebuje poljavoice_id,nameinlanguage, xAI pa ponuja 28 vgrajenih glasov. Viri: Voice API · Text to Speech.
Programsko odkrivanje glasov
Namesto da bi seznam glasov v svoji aplikaciji trdo kodiral, ti API xAI ponuja namensko končno točko za dinamično pridobivanje razpoložljivih glasov. Tako boš vedno posodobljen, ko dodajo nove glasove.
GET /v1/tts/voices
Ta končna točka vrne seznam vseh glasov, ki so na voljo za pretvorbo besedila v govor (TTS). V telesu zahteve ne potrebuje nobenih parametrov.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Odgovor je objekt JSON, ki vsebuje polje voices. Glede na referenčno dokumentacijo ima vsak glas tri polja: voice_id (ID v malih črkah, ki ga posreduješ v svojih zahtevah), name (prikazno ime) in language (jezikovna koda, ki je lahko null).
Oblika odgovora
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Tri pike nadomeščajo vrednosti, ki jih referenčna dokumentacija ne navaja kot primere: preden se zanašaš na odgovor, enkrat izpiši dejanski odgovor. Ton in primeri uporabe za vsak glas niso del tega odgovora; opisani so na strani xAI Text to Speech.
GET /v1/tts/voices/{voice_id}
Če želiš pridobiti podrobnosti o določenem glasu, dodaj njegov ID v pot:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Ta klic vrne enaka polja (voice_id, name, language) le za zahtevani glas.
Izbira pravega glasu
xAI ponuja 28 vgrajenih glasov (stanje na dan 3. novembra 2026) in za večino njih opisuje, za kaj so najbolj primerni. Nekaj smernic s te strani:
- Izobraževalne vsebine:
luna,cosmoalilumen, navedeni za izobraževanje - Podpora strankam:
carina,iris,rigel,celeste,castor,nakshaliaurora, navedeni za podporo - Oglasi in demonstracije:
altair,zenith,perseus,kepleralilumen, navedeni za oglaševanje;eve, energičen in vedro glas, ostaja privzeti glas - Pripovedovanje in avdio knjige:
orion,zagan,altair,perseusalilux - Dobro počutje:
carina,helios,luxaliliora
Pet originalnih glasov (eve, ara, rex, sal, leo) nima navedenih primerov uporabe: xAI jih opisuje le kot energične in vedre (britanski naglas), tople in prijazne, samozavestne in jasne, gladke in uravnotežene ter avtoritativne in mogočne (britanski naglas).
Vgradnja izbire glasu v aplikacijo
Tukaj je primer, ki dinamično naloži razpoložljive 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
Ta pristop te ščiti pred tipkarskimi napakami v ID-jih glasov in ti omogoča, da uporabnikom ponudiš posodobljen seznam.
Najboljše prakse
- Predpomni seznam glasov: končna točka
/v1/tts/voicesse ne spreminja pogosto, zato zadostuje en klic ob zagonu aplikacije - Ponudi predogled: dovoli uporabnikom, da poslušajo vzorec vsakega glasu, preden ga izberejo
- Shrani nastavitve: ko uporabnik izbere glas, shrani to izbiro za prihodnje seje
- Testiraj v ciljnem jeziku: glas, ki odlično zveni v angleščini, se lahko v drugem jeziku sliši drugače. Vedno testiraj v jeziku svoje aplikacije
Ključne ugotovitve
GET /v1/tts/voicesizpiše vse razpoložljive glasove z njihovimi metapodatkiGET /v1/tts/voices/{voice_id}vrne podrobnosti o določenem glasu- Na voljo je 28 vgrajenih glasov; njihov ton in primeri uporabe so opisani na strani xAI Text to Speech
- Odgovor na
GET /v1/tts/voicesza vsak glas vsebujevoice_id,nameinlanguage - Glasove naloži dinamično, namesto da bi jih trdo kodiral