Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Išvardykite galimas balsus

Paskaita 3 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Programiškai atraskite balsus
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Pasirinkite tinkamą balsą
  5. Integruokite balso pasirinkimą į savo programą
  6. Geriausios praktikos
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d., remiantis xAI Voice API nuoroda ir Text to Speech puslapiu: GET /v1/tts/voices atsakas pateikia voice_id, name ir language, o xAI siūlo 28 integruotus balsus. Šaltiniai: Voice API · Text to Speech.

Programiškai atraskite balsus

Užuot įkodavę balsų sąrašą tiesiai į savo programą, xAI API suteikia specialų galinį tašką dinamiškam galimų balsų gavimui. Taip užtikrinsite, kad jūsų sistema visada bus atnaujinta, kai tik atsiranda naujų balsų.

GET /v1/tts/voices

Šis galinis taškas grąžina visų TTS prieinamų balsų sąrašą. Užklausos kūne jokių parametrų nurodyti nereikia.

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

Atsakas yra JSON objektas, kuriame yra voices masyvas. Pagal API nuorodą, kiekvienas balsas turi tris laukus: voice_id – mažosiomis raidėmis rašomas ID, kurį perduodate savo užklausose; name – rodomas pavadinimas; ir language – kalbos kodas, kuris gali būti null.

Atsako struktūra

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

Taškai žymi reikšmes, kurių nuoroda nepateikia kaip pavyzdžių: prieš pasikliaudami šiais duomenimis, vieną kartą atspausdinkite tikrąjį atsaką. Šiame atsake nepateikiama kiekvieno balso tonacija ir naudojimo atvejai; jie aprašyti xAI Text to Speech puslapyje.

GET /v1/tts/voices/{voice_id}

Norėdami gauti konkretaus balso išsamią informaciją, pridėkite jo ID į kelio dalį:

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

Šis kvietimas grąžina tuos pačius laukus (voice_id, name, language), bet tik prašomam balsui.

Pasirinkite tinkamą balsą

xAI siūlo 28 integruotus balsus (2026 m. lapkričio 3 d. duomenimis) ir daugumai jų aprašo, kam jie labiausiai tinka. Keletas patarimų iš to puslapio:

  • Švietimo turinys: luna, cosmo arba lumen, išvardyti švietimo tikslams
  • Klientų aptarnavimas: carina, iris, rigel, celeste, castor, naksh arba aurora, išvardyti palaikymo tikslams
  • Reklama ir demonstracijos: altair, zenith, perseus, kepler arba lumen, išvardyti reklamai; eve, energingas ir linksmas, lieka numatytuoju balsu
  • Pasakojimai ir garso knygos: orion, zagan, altair, perseus arba lux
  • Sveikata ir gerovė: carina, helios, lux arba liora

Penki originalūs balsai (eve, ara, rex, sal, leo) neturi nurodytų naudojimo atvejų: xAI juos apibūdina tik kaip energingus ir linksmus (britų akcentas), šiltus ir draugiškus, pasitikinčius ir aiškius, sklandžius ir subalansuotus bei autoritetingus ir galingus (britų akcentas).

Integruokite balso pasirinkimą į savo programą

Štai pavyzdys, kaip dinamiškai įkelti galimus balsus:

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

Šis požiūris apsaugo jus nuo rašybos klaidų balsų ID ir leidžia vartotojams pasiūlyti naujausią sąrašą.

Geriausios praktikos

  • Talpinkite balsų sąrašą į podėlį: /v1/tts/voices galinis taškas keičiasi retai, todėl užtenka vieno kvietimo programos paleidimo metu
  • Pasiūlykite peržiūrą: leiskite vartotojams paklausyti kiekvieno balso pavyzdžio prieš renkantis
  • Įsiminkite pasirinkimą: kai vartotojas pasirenka balsą, išsaugokite šį pasirinkimą būsimiems seansams
  • Testuokite tiksline kalba: balsas, skambantis puikiai angliškai, kitoje kalboje gali skambėti kitaip. Visada testuokite savo programos kalba

Svarbiausi punktai

  • GET /v1/tts/voices išvardija visus galimus balsus su jų metaduomenimis
  • GET /v1/tts/voices/{voice_id} pateikia konkretaus balso išsamią informaciją
  • Yra prieinama 28 integruoti balsai; jų tonacija ir naudojimo atvejai aprašyti xAI Text to Speech puslapyje
  • GET /v1/tts/voices atsakas kiekvienam balsui pateikia voice_id, name ir language
  • Balsus įkelkite dinamiškai, užuot juos įkodavę tiesiai į kodą