Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Izpiši razpoložljive glasove

Lekcija 3 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Programsko odkrivanje glasov
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Izbira pravega glasu
  5. Vgradnja izbire glasu v aplikacijo
  6. Najboljše prakse
  7. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi referenčne dokumentacije za xAI Voice API in strani Text to Speech: odgovor na klic GET /v1/tts/voices vsebuje polja voice_id, name in language, 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, cosmo ali lumen, navedeni za izobraževanje
  • Podpora strankam: carina, iris, rigel, celeste, castor, naksh ali aurora, navedeni za podporo
  • Oglasi in demonstracije: altair, zenith, perseus, kepler ali lumen, navedeni za oglaševanje; eve, energičen in vedro glas, ostaja privzeti glas
  • Pripovedovanje in avdio knjige: orion, zagan, altair, perseus ali lux
  • Dobro počutje: carina, helios, lux ali liora

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/voices se 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/voices izpiše vse razpoložljive glasove z njihovimi metapodatki
  • GET /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/voices za vsak glas vsebuje voice_id, name in language
  • Glasove naloži dinamično, namesto da bi jih trdo kodiral