xAI SDK AsyncClient
Ar an leathanach seo
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.
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
AsyncClientSDK xAI duit iarratais a sheoladh gan rith a bhac - Tá an paraiméadar
timeout=3600riachtanach do mhúnlaí réasúnaíochta - Éilíonn
xai-sdkPython 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