Ilista l-vuċijiet disponibbli
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026, ibbażat fuq ir-referenza tal-API tal-Vuċi ta’ xAI u l-paġna Text to Speech: ir-rispons ta’
GET /v1/tts/voicesiġorrvoice_id,name, ulanguage, u xAI toffri 28 vuċi integrati. Sorsi: Voice API · Text to Speech.
Skopri l-vuċijiet programmatikament
Minflok ma tħalli l-lista tal-vuċijiet imwaħħla b’mod riġidu fl-app tiegħek, l-API ta’ xAI tipprovdi endpoint iddedikat biex tiġbed il-vuċijiet disponibbli b’mod dinamiku. Hekk tibqa’ aġġornat kull meta jiżdiedu vuċijiet ġodda.
GET /v1/tts/voices
Dan l-endpoint jirritorna l-lista tal-vuċijiet kollha disponibbli għat-TTS. Ma jeħtieġ l-ebda parametru fil-korp tat-talba.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Ir-rispons huwa oġġett JSON li fih array voices. Skont ir-referenza tal-API, kull vuċi għandha tliet oqsma: voice_id, l-ID b’ittri żgħar li tgħaddi fit-talbiet tiegħek; name, isem għall-wiri; u language, kodiċi tal-lingwa li jista’ jkun null.
Forma tar-rispons
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Il-puntijiet issostitwixxu valuri li r-referenza ma tagħtix bħala eżempji: ipprintja r-rispons reali darba qabel ma tiddependi fuqu. It-ton u l-każijiet ta’ użu ta’ kull vuċi mhumiex f’dan ir-rispons; huma deskritti fil-paġna Text to Speech ta’ xAI.
GET /v1/tts/voices/{voice_id}
Biex tikseb id-dettalji ta’ vuċi speċifika, żid l-ID tagħha fil-mogħdija:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Din is-sejħa tirritorna l-istess oqsma (voice_id, name, language) għall-vuċi mitluba biss.
Agħżel il-vuċi t-tajba
xAI toffri 28 vuċi integrati (sal-3 ta’ Novembru 2026) u, għall-biċċa l-kbira tagħhom, tiddeskrivi għal xiex huma l-aktar adattati. Hawn xi pariri minn dik il-paġna:
- Kontenut edukattiv:
luna,cosmo, jewlumen, elenkati għall-edukazzjoni - Appoġġ lill-klijenti:
carina,iris,rigel,celeste,castor,naksh, jewaurora, elenkati għall-appoġġ - Reklamar u demos:
altair,zenith,perseus,kepler, jewlumen, elenkati għar-reklamar;eve, enerġetika u b’ton pożittiv, tibqa’ l-vuċi predefinita - Narrazzjoni u awdibkotks:
orion,zagan,altair,perseus, jewlux - Benesseri:
carina,helios,lux, jewliora
Il-ħames vuċijiet oriġinali (eve, ara, rex, sal, leo) m’għandhom l-ebda każ ta’ użu elenkat: xAI tiddeskrivihom biss bħala enerġetiċi u b’ton pożittiv (aċċent Brittaniku), sħan u ħbieb, kunfidenti u ċari, lixxi u bbilanċjati, u awtorevoli u qawwija (aċċent Brittaniku).
Ibni l-għażla tal-vuċi fl-app tiegħek
Hawn eżempju li jħassar il-vuċijiet disponibbli b’mod dinamiku:
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
Dan l-approċċ jipproteġik minn żbalji fit-tipjar tal-IDs tal-vuċijiet u jħallik toffri lill-utenti tiegħek lista aġġornata.
Prattiki tajba
- Ikkaxxja l-lista tal-vuċijiet: l-endpoint
/v1/tts/voicesma jinbidilx spiss, allura sejħa waħda meta l-app tiegħek tibda biżżejjed - Offri prevja: ħalli lill-utenti tiegħek jisimgħu kampjun ta’ kull vuċi qabel ma jagħżlu
- Iħżen il-preferenza: ladarba utent jagħżel vuċi, aħżen l-għażla għas-sessjonijiet futuri
- Ittestja fil-lingwa fil-mira: vuċi li tinstema’ kbira bl-Ingliż tista’ tinstema’ differenti f’lingwa oħra. Dejjem ittestja fil-lingwa tal-app tiegħek
Punti Ewlenin
GET /v1/tts/voicesjelenka l-vuċijiet disponibbli kollha bil-metadejta tagħhomGET /v1/tts/voices/{voice_id}jagħti d-dettalji ta’ vuċi speċifika- Hemm 28 vuċi integrata disponibbli; it-ton u l-każijiet ta’ użu tagħhom huma deskritti fil-paġna Text to Speech ta’ xAI
- Ir-rispons ta’
GET /v1/tts/voicesjagħtivoice_id,name, ulanguagegħal kull vuċi - Iħħarġja l-vuċijiet b’mod dinamiku minflok ma tħallihom imwaħħla b’mod riġidu