Išvardykite galimas balsus
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d., remiantis xAI Voice API nuoroda ir Text to Speech puslapiu:
GET /v1/tts/voicesatsakas pateikiavoice_id,nameirlanguage, 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,cosmoarbalumen, išvardyti švietimo tikslams - Klientų aptarnavimas:
carina,iris,rigel,celeste,castor,naksharbaaurora, išvardyti palaikymo tikslams - Reklama ir demonstracijos:
altair,zenith,perseus,keplerarbalumen, išvardyti reklamai;eve, energingas ir linksmas, lieka numatytuoju balsu - Pasakojimai ir garso knygos:
orion,zagan,altair,perseusarbalux - Sveikata ir gerovė:
carina,helios,luxarbaliora
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/voicesgalinis 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/voicesišvardija visus galimus balsus su jų metaduomenimisGET /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/voicesatsakas kiekvienam balsui pateikiavoice_id,nameirlanguage- Balsus įkelkite dinamiškai, užuot juos įkodavę tiesiai į kodą