Liostaigh na guthanna atá ar fáil
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026, bunaithe ar thagairt API Guth xAI agus ar an leathanach Text to Speech: tá
voice_id,name, aguslanguagesa fhreagra óGET /v1/tts/voices, agus tá 28 nguth ionsuite ar fáil ó xAI. Foincí: Voice API · Text to Speech.
Faigh amach faoi ghuthanna go cláraithe
In ionad liosta na nguthanna a chódú go docht i d’fheidhmchlár, soláthraíonn API xAI críochphoint tiomnaithe chun na guthanna atá ar fáil a fháil go dinimiciúil. Ar an mbealach sin, fanfaidh tú cothrom le dáta nuair a chuirfear guthanna nua leis.
GET /v1/tts/voices
Tugann an críochphoint seo liosta de na guthanna go léir atá ar fáil le haghaidh TTS. Ní gá aon pharaiméadair sa chorp iarratais.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Is réad JSON é an freagra ina bhfuil eagar voices. De réir thagairt an API, tá trí réimse ag gach guth: voice_id, an t-aithneoir litreacha beaga le cur i d’iarratais; name, ainm taispeána; agus language, cód teanga ar féidir leis a bheith null.
Cruth an fhreagra
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Seasann na heilipsí do luachanna nach dtugann an tagairt mar shamplaí: priontáil an freagra fíor uair amháin sula mbraitheann tú air. Níl tón agus cásanna úsáide gach ghuith sa fhreagra seo; tá siad curtha síos ar leathanach Text to Speech xAI.
GET /v1/tts/voices/{voice_id}
Chun mionsonraí faoi ghuth sonrach a fháil, cuir a aithneoir leis an gcosán:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Tugann an glao seo na réimsí céanna (voice_id, name, language) don ghuth a iarradh amháin.
Roghnaigh an guth ceart
Tá 28 nguth ionsuite ar fáil ó xAI (faoi láthair an 3 Samhain, 2026) agus, don chuid is mó acu, déantar cur síos ar an méid is oiriúnaí iad dóibh. Seo roinnt leideanna ón leathanach sin:
- Ábhar oideachais:
luna,cosmo, nólumen, atá liostaithe don oideachas - Tacaíocht do chustaiméirí:
carina,iris,rigel,celeste,castor,naksh, nóaurora, atá liostaithe don tacaíocht - Fógraíocht agus taispeántais:
altair,zenith,perseus,kepler, nólumen, atá liostaithe don fhógraíocht; is éeve, atá fuinniúil agus dearfach, fós an guth réamhshocraithe - Léamh agus leabhair fuaime:
orion,zagan,altair,perseus, nólux - Folláine:
carina,helios,lux, nóliora
Níl aon chásanna úsáide liostaithe ag na cúig ghuth bunaidh (eve, ara, rex, sal, leo): ní dhéanann xAI ach cur síos orthu mar ghuthanna fuinniúla agus dearfacha (blas Briotanach), te agus cairdiúil, muiníneach agus soiléir, réidh agus cothromaithe, agus údarásach agus cumhachtach (blas Briotanach).
Cuir roghnú gutha san áireamh i d’fheidhmchlár
Seo sampla a lódálann na guthanna atá ar fáil go dinimiciúil:
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
Cosnaíonn an cur chuige seo thú in aghaidh botúin chlóscríofa in aitheantóirí gutha agus ligeann sé duit liosta cothrom le dáta a thairiscint do d’úsáideoirí.
Dea-chleachtais
- Taisc liosta na nguthanna: ní athraíonn an críochphoint
/v1/tts/voicesgo minic, mar sin is leor glao amháin nuair a thosaíonn d’fheidhmchlár - Tairisc réamhamharc: lig do d’úsáideoirí sampla de gach guth a éisteacht sula roghnaíonn siad é
- Sábháil an rogha: nuair a bheidh guth roghnaithe ag úsáideoir, stóráil an rogha sin do sheisiúin amach anseo
- Déan tástáil sa teanga sprioc: d’fhéadfadh guth a bhfuil cuma mhaith air i mBéarla bheith difriúil i dteanga eile. Déan tástáil i gcónaí i dteanga d’fheidhmchláir
Príomhphointí
- Liostaíonn
GET /v1/tts/voicesna guthanna ar fáil go léir lena meiteashonraí - Tugann
GET /v1/tts/voices/{voice_id}mionsonraí faoi ghuth sonrach - Tá 28 nguth ionsuite ar fáil; tá cur síos ar a dtonn agus ar a gcásanna úsáide ar leathanach Text to Speech xAI
- Tugann freagra
GET /v1/tts/voicesvoice_id,name, aguslanguagedo gach guth - Lódáil na guthanna go dinimiciúil in ionad iad a chódú go docht