Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ilista l-vuċijiet disponibbli

Lezzjoni 3 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Skopri l-vuċijiet programmatikament
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Agħżel il-vuċi t-tajba
  5. Ibni l-għażla tal-vuċi fl-app tiegħek
  6. Prattiki tajba
  7. Punti Ewlenin

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/voices iġorr voice_id, name, u language, 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, jew lumen, elenkati għall-edukazzjoni
  • Appoġġ lill-klijenti: carina, iris, rigel, celeste, castor, naksh, jew aurora, elenkati għall-appoġġ
  • Reklamar u demos: altair, zenith, perseus, kepler, jew lumen, elenkati għar-reklamar; eve, enerġetika u b’ton pożittiv, tibqa’ l-vuċi predefinita
  • Narrazzjoni u awdibkotks: orion, zagan, altair, perseus, jew lux
  • Benesseri: carina, helios, lux, jew liora

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/voices ma 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/voices jelenka l-vuċijiet disponibbli kollha bil-metadejta tagħhom
  • GET /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/voices jagħti voice_id, name, u language għal kull vuċi
  • Iħħarġja l-vuċijiet b’mod dinamiku minflok ma tħallihom imwaħħla b’mod riġidu