Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Uzskaitīt pieejamās balsis

Nodarbība 3 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Balsu programmētiska atklāšana
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Izvēlies pareizo balsi
  5. Iekļauj balss izvēli savā lietotnē
  6. Labākā prakse
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI Voice API atsauces dokumentāciju un lapu Text to Speech: atbilde no GET /v1/tts/voices satur laukus voice_id, name un language, un xAI piedāvā 28 iebūvētās balsis. Avoti: Voice API · Text to Speech.

Balsu programmētiska atklāšana

Tā vietā, lai balsu sarakstu savā lietotnē iekodētu cieti (hard-code), xAI API nodrošina specializētu galapunktu pieejamo balsu dinamiskai iegūšanai. Tādējādi tu paliksi informēts, kad tiek pievienotas jaunas balsis.

GET /v1/tts/voices

Šis galapunkts atgriež visu TTS pieejamo balsu sarakstu. Pieprasījuma ķermenim parametri nav nepieciešami.

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

Atbilde ir JSON objekts, kas satur masīvu voices. Saskaņā ar API atsauces dokumentāciju katrai balsij ir trīs lauki: voice_id (mazajiem burtiem rakstīts ID, kas jānorāda pieprasījumos), name (attēlojamais nosaukums) un language (valodas kods, kas var būt null).

Atbildes struktūra

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

Daļsvītras apzīmē vērtības, kuras atsauces dokumentācija nesniedz kā piemērus: pirms paļauties uz tām, vienreiz izdrukā reālo atbildi. Katras balss tonis un lietojuma gadījumi šajā atbildē nav iekļauti; tie ir aprakstīti xAI lapā Text to Speech.

GET /v1/tts/voices/{voice_id}

Lai iegūtu konkrētas balss detaļas, pievieno tās ID ceļam:

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

Šis izsaukums atgriež tos pašus laukus (voice_id, name, language) tikai pieprasītajai balsij.

Izvēlies pareizo balsi

xAI piedāvā 28 iebūvētās balsis (pēc 2026. gada 3. novembra datiem), un lielākajai daļai no tām ir aprakstīts, kam tās ir vispiemērotākās. Daži norādījumi no minētās lapas:

  • Izglītības saturs: luna, cosmo vai lumen, kas uzskaitītas izglītības vajadzībām
  • Klientu atbalsts: carina, iris, rigel, celeste, castor, naksh vai aurora, kas uzskaitītas atbalsta vajadzībām
  • Reklāma un demonstrācijas: altair, zenith, perseus, kepler vai lumen, kas uzskaitītas reklāmai; eve, enerģiska un dzīvespriecīga, paliek noklusējuma balss
  • Lasījumi un audiogrāmatas: orion, zagan, altair, perseus vai lux
  • Labjutība: carina, helios, lux vai liora

Piecām oriģinālajām balsīm (eve, ara, rex, sal, leo) nav norādīti konkrēti lietojuma gadījumi: xAI tās raksturo tikai kā enerģiskas un dzīvespriecīgas (britu akcents), siltas un draudzīgas, pārliecinātas un skaidras, gludas un sabalansētas, kā arī autoritatīvas un spēcīgas (britu akcents).

Iekļauj balss izvēli savā lietotnē

Lūk, piemērs, kā dinamiski ielādēt pieejamās balsis:

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

Šī pieeja pasargā tevi no kļūdām balss ID rakstībā un ļauj piedāvāt lietotājiem aktuālu sarakstu.

Labākā prakse

  • Kešo balsu sarakstu: galapunkts /v1/tts/voices mainās reti, tāpēc pietiek ar vienu izsaukumu lietotnes startēšanas brīdī
  • Piedāvā priekšskatījumu: ļauj lietotājiem noklausīties katra balss paraugu pirms izvēles
  • Saglabā preferenci: tiklīdz lietotājs ir izvēlējies balsi, saglabā šo izvēli nākamajām sesijām
  • Testē mērķvalodā: balss, kas izklausās lieliski angļu valodā, citā valodā var skanēt citādāk. Vienmēr veic testēšanu savas lietotnes valodā

Galvenās atziņas

  • GET /v1/tts/voices uzskaita visas pieejamās balsis kopā ar to metadatiem
  • GET /v1/tts/voices/{voice_id} sniedz konkrētas balss detaļas
  • Pieejamas 28 iebūvētās balsis; to toņi un lietojuma gadījumi ir aprakstīti xAI lapā Text to Speech
  • Atbilde no GET /v1/tts/voices katrai balsij sniedz voice_id, name un language
  • Ielādē balsis dinamiski, nevis iekodē tās cieti