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

xAI SDK AsyncClient

Ceacht 1 as 12 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Cén fáth a n-aistreofá chuig asinc
  2. An AsyncClient a thúsú
  3. Iarratas asinc a sheoladh
  4. An difríocht leis an gcliant sioncronach
  5. Príomhphointí

Cén fáth a n-aistreofá chuig asinc

Nuair a dhéanann tú ceist ar API xAI go sioncronach, stopann gach glao rith do chláir go dtí go dtagann an freagra. I gcás múnla réasúnaíochta cosúil le grok-4.5, féadfaidh aon iarratas amháin roinnt deichnead soicind a thógáil. Má tá ort 100 iarratas a phróiseáil, éireoidh an t-am feithimh iomlán rófhada.

Réitíonn an mód asinc an fhadhb seo. In ionad feitheamh ar gach freagra, seolann do chlár an t-iarratas agus leanann sé ar aghaidh ag rith. Faigheann tú an toradh níos déanaí, nuair a bheidh sé ar fáil. Ligeann an cur chuige seo duit iliomad iarratas a phróiseáil i gcomhthráth agus do leithead banda chuig an API a úsáid go hiomlán.

3600s
Recommended timeout
5x
Parallel throughput
-50%
Batch API alternative
RPM
Rate limit to respect

An AsyncClient a thúsú

Soláthraíonn SDK xAI an rang AsyncClient atá tiomnaithe do ghlonna asinc. Tá an túsú cosúil leis an gcliant sioncronach, ach tá paraiméadar timeout ann nach mór duit a chumrú i gcónaí:

import os
from xai_sdk import AsyncClient
from xai_sdk.chat import user

client = AsyncClient(
    api_key=os.getenv("XAI_API_KEY"),
    timeout=3600,
)

Ciallaíonn timeout=3600 uair an chloig. D’fhéadfadh an luach seo a bheith ard, ach tá sé riachtanach do mhúnlaí réasúnaíochta a dhéanann réasúnú fada sula bhfreagraíonn siad. Má tá an t-am-teorainn róghairid, tarlóidh earráidí titime ceangail ar iarratais chasta.

Iarratas asinc a sheoladh

Nuair a bheidh an cliant túsaithe agat, seolann tú iarratais trí chomhréir await Python a úsáid:

import asyncio

async def ask_grok(question: str) -> str:
    chat = client.chat.create(
        model="grok-4.20-0309-reasoning",
        max_tokens=500
    )
    chat.append(user(question))
    response = await chat.sample()
    return response.text

# Pointe iontrála
result = asyncio.run(ask_grok("Explain the algorithmic complexity of quicksort"))
print(result)

Úsáideann an fheidhm ask_grok async def, rud a fhágann gur coraitín í. Cuireann an glao await chat.sample() an coraitín seo ar fionraí go dtí go dtagann an freagra, gan bac a chur ar aon tascanna eile a d’fhéadfadh a bheith ann.

An difríocht leis an gcliant sioncronach

Bacann an cliant sioncronach an snáithe reatha ar feadh thréimhse iomlán an iarratais. Saorálann an cliant asinc an snáithe chun coraitíní eile a rith. Ní chiallaíonn an t-idirdhealú seo mórán má sheolann tú aon iarratas amháin, ach éiríonn sé ríthábhachtach nuair a phróiseálann tú iliomad iarratas i gcomhthráth.

# Sioncronach: fanann gach glao ar an bhfreagra
for question in questions:
    response = client.chat.completions.create(...)  # blocking
    process(response)

# Asinc: ritheann glonna i gcomhthráth
async def main():
    tasks = [ask_grok(q) for q in questions]
    responses = await asyncio.gather(*tasks)  # parallel
    for r in responses:
        process(r)

Sa sampla sioncronach, má thógann gach iarratas 10 soicind agus má tá 20 acu agat, is é 200 soicind an t-am iomlán. Sa mhód asinc le seimeafar de 5 (rud a fhoghlaimeoidh tú i gcúrsaí ina dhiaidh sin), laghdaítear an t-am go dtí thart ar 40 soicind.

Príomhphointí

  • Ligeann AsyncClient SDK xAI duit iarratais a sheoladh gan rith a bhac
  • Tá an paraiméadar timeout=3600 riachtanach do mhúnlaí réasúnaíochta
  • Éilíonn xai-sdk Python 3.10 nó níos déanaí (leagan 1.21.0 ón 2 Samhain 2026, de réir PyPI)
  • Tagann an sochar fíor chun solais nuair a phróiseálann tú iliomad iarratas i gcomhthráth
  • Feidhmíonn asyncio.run() mar phointe iontrála chun coraitín a rith ó chód sioncronach