Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Liostaigh na guthanna atá ar fáil

Ceacht 3 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Faigh amach faoi ghuthanna go cláraithe
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Roghnaigh an guth ceart
  5. Cuir roghnú gutha san áireamh i d’fheidhmchlár
  6. Dea-chleachtais
  7. Príomhphointí

Nuashonraithe an 3 Samhain, 2026, bunaithe ar thagairt API Guth xAI agus ar an leathanach Text to Speech: tá voice_id, name, agus language sa 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/voices go 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/voices na 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/voices voice_id, name, agus language do gach guth
  • Lódáil na guthanna go dinimiciúil in ionad iad a chódú go docht