Uzskaitīt pieejamās balsis
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI Voice API atsauces dokumentāciju un lapu Text to Speech: atbilde no
GET /v1/tts/voicessatur laukusvoice_id,nameunlanguage, 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,cosmovailumen, kas uzskaitītas izglītības vajadzībām - Klientu atbalsts:
carina,iris,rigel,celeste,castor,nakshvaiaurora, kas uzskaitītas atbalsta vajadzībām - Reklāma un demonstrācijas:
altair,zenith,perseus,keplervailumen, kas uzskaitītas reklāmai;eve, enerģiska un dzīvespriecīga, paliek noklusējuma balss - Lasījumi un audiogrāmatas:
orion,zagan,altair,perseusvailux - Labjutība:
carina,helios,luxvailiora
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/voicesmainā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/voicesuzskaita visas pieejamās balsis kopā ar to metadatiemGET /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/voiceskatrai balsij sniedzvoice_id,nameunlanguage - Ielādē balsis dinamiski, nevis iekodē tās cieti