xAI SDK: client.chat.create
Ar an leathanach seo
Nuashraithe an 3 Samhain 2026. Ghlac an leagan roimhe seo leis go n-úsáideadh an
xai-sdkcomhéadan an OpenAI SDK: teachtaireachtaí mar fhoclóirí,response.choices[0].message.content, an paraiméadarstream=True, agus modúlxai_sdk.errorsnach bhfuil ann. Leis an SDK iarbhír (leagan 1.21.0), teipeann ar an gcód sin ag an gcéad ghla:ValueError: unknown enum label "user". Leanann an ceacht seo anois README oifigiúil an SDK, agus rithadh gach sampla i gcoinne API xAI (le heochair bhréige, chun an cosán glaonna agus na hearráidí a fhíorú). Foinse: xAI Python SDK · Dea-chleachtais (xAI) · Earráidí a dhífhabhtú (xAI).
An SDK dúchasach xAI
Ní úsáideann an SDK oifigiúil xAI do Python, xai-sdk, an pointe críche REST Chat Completions: is leabharlann gRPC é, le cliant comhthreomhar (Client) agus cliant neamh-chomhthreomhar (AsyncClient), do Python 3.10 agus níos déanaí. Ní dhéanann sé iarracht aithris a dhéanamh ar an OpenAI SDK, agus sin an chéad rud le cuimhneamh air: tá struchtúr dá gcuid féin ag a chuid oibiachtí, modhanna agus earráidí. Chun cód a scríobhadh do OpenAI a athúsáid, taispeánfaidh an chéad cheacht eile an cosán eile, an OpenAI SDK cumraithe don API xAI.
Suiteáil agus fíordheimhniú
pip install xai-sdk
Baineann an fíordheimhniú úsáid as eochair API a cruthaíodh sa chonsól xAI. Cuir san athróg timpeallachta XAI_API_KEY é, a léann an cliant go huathoibríoch:
export XAI_API_KEY="your-api-key"
Comhrá, seachas iarratas
Leis an SDK seo, ní sheolann client.chat.create() aon rud: cruthaíonn sé oibiacht comhrá (chat), a gcuireann tú teachtaireachtaí leis trí append, agus ansin iarrann tú freagra le sample(). Tógtar teachtaireachtaí leis na feidhmeanna system, user, agus assistant ón modúl xai_sdk.chat, seachas le foclóirí.
from xai_sdk import Client
from xai_sdk.chat import system, user
client = Client() # léann sé XAI_API_KEY
chat = client.chat.create(
model="grok-4.7",
messages=[system("You are a helpful assistant. Respond in French.")],
)
chat.append(user("Explain deep learning in 3 sentences."))
response = chat.sample()
print(response.content)
Nochtann an freagra a chuid téacs go díreach in response.content, in éineacht le finish_reason, usage (tokain a úsáideadh), reasoning_content do mhúnlaí a nochtann é, agus citations nuair a rinneadh cuardach.
Fanann an API gan stát: coinníonn an oibiacht chat an stair duitse. I gcomhair comhrá il-chasadh, cuir an freagra leis an snáithe sula dtugtar an chéad cheist eile:
chat.append(response)
chat.append(user("Give a concrete example of an application."))
print(chat.sample().content)
Paraiméadair ghiniúna
Cuirtear paraiméadair ar client.chat.create() agus baineann siad leis an gcomhrá ar fad:
chat = client.chat.create(
model="grok-4.7",
messages=[system("Respond only in JSON.")],
temperature=0.7,
top_p=0.95,
reasoning_effort="medium",
)
model: an t-aithneoir múnla. Molann xAIgrok-4.7do gach úsáid.messages: na teachtaireachtaí tosaigh, tógtha lesystem,user, agusassistant.temperature: Glacann an API le luachanna idir 0 agus 2, ach cuireann xAI teorainn leis ag 1 thairis sin agus molann sé 0.7, letop_pag 0.95.max_tokens: an líon uasta tokain a ghinfear. Molann dea-chleachtais xAI é a shocrú os cionn na freagra is faide a bhfuiltear ag súil leis, nó an luach réamhshocraithe a fhágáil.reasoning_effort: doimhneacht na réasúnaíochta, ónonegohigh(agusxhighar roinnt múnlaí). Braitheann an réamhshocrú ar an múnla: molann xAI é a shocrú go sainráite ar gach iarratas, agus é a thabhairt faoi deara le gach toradh.response_format,tools,tool_choice: aschuir struchtúrtha agus glaonna uirlisí, a phléifear níos déanaí sa chúrsa.
Tá stop ann freisin (suas le ceithre sheicheamh), ach sonraíonn dea-chleachtais xAI nach nglacann múnlaí réasúnaíochta leis, ná le presence_penalty agus frequency_penalty.
Freagraí sruthaithe
Molann xAI sruthú, go háirithe le múnlaí réasúnaíochta, ar féidir go dtógfadh sé i bhfad ar a bhfreagraí teacht. Ní úsáideann sé paraiméadar: tá dara modh ag an gcomhrá, stream(), a thugann péire (response, chunk) ag gach céim. Tá an blúire téacs a tháinig isteach go díreach i chunk.content, agus carnann response an freagra iomlán ar fud an tsrutha.
chat = client.chat.create(model="grok-4.7")
chat.append(user("Write a short article on generative AI."))
for response, chunk in chat.stream():
print(chunk.content, end="", flush=True)
print()
chat.append(response) # téann an freagra iomlán isteach sa stair
Láimhseáil earráidí
Ós rud é go labhraíonn an SDK gRPC, is iad grpc.RpcError a chuid earráidí (go neamh-chomhthreomhar, grpc.aio.AioRpcError, a thagann ina n-oidhreacht orthu). Léann tú a gcód le .code() agus an teachtaireacht le .details():
import grpc
from xai_sdk import Client
from xai_sdk.chat import user
client = Client()
chat = client.chat.create(model="grok-4.7")
chat.append(user("Hello"))
try:
response = chat.sample()
print(response.content)
except grpc.RpcError as error:
if error.code() == grpc.StatusCode.DEADLINE_EXCEEDED:
print("Timeout exceeded: the request took too long.")
else:
print(f"Error {error.code().name}: {error.details()}")
Tá trí iompraíocht ar fiú a bheith ar an eolas fúthu. Déanann an SDK athriachtail ar a chonlán féin ar iarratais a theipeann le UNAVAILABLE, suas le cúig iarracht le moill mhéadaitheach; taispeánann a README conas cóid eile a chur leis an liosta seo, mar shampla RESOURCE_EXHAUSTED, an cód gRPC do chuótaí ídithe. Is é an t-am feithimh teorann 27 nóiméad go réamhshocraithe d’aon iarratas agus socraítear é ag cruthú an chliaint (Client(timeout=…), i soicindí). Ná laghdaigh é ró-mhór: comhairlíonn xAI pleanáil do 900 soicind ar a laghad in aghaidh an iarrtais lena chuid múnlaí réasúnaíochta. Ar deireadh, léiríonn eochair API neamhbhailí mar chód INVALID_ARGUMENT agus an teachtaireacht “Incorrect API key provided”: sin é a thugann an API ar ais inniu, fíoraithe an 3 Samhain 2026.
Glaonna neamh-chomhthreomhara
Chun feidhmchlár asyncio a úsáid, cuir AsyncClient in ionad Client. Fanann cruthú an chomhrá comhthreomhar; is iad sample() agus stream() na cinn a bhíonn ag feitheamh (await):
import asyncio
from xai_sdk import AsyncClient
from xai_sdk.chat import user
async def main():
client = AsyncClient()
chat = client.chat.create(model="grok-4.7")
chat.append(user("Hello"))
response = await chat.sample()
print(response.content)
chat.append(response)
chat.append(user("Summarize your response in one sentence."))
async for response, chunk in chat.stream():
print(chunk.content, end="", flush=True)
asyncio.run(main())
Príomhphointí
- Is SDK gRPC é
xai-sdk, lena chomhéadan féin: ní athúsáideann sé cruth ná oibiachtaí an OpenAI SDK - Cruthaíonn
client.chat.create()comhrá; cuireannchat.append(user(...))teachtaireacht leis, agus filleannchat.sample()an freagra, a léitear inresponse.content - Tógtar teachtaireachtaí le
system,user, agusassistantóxai_sdk.chat; cúisíonn foclóirí teip ar an nglao - Úsáideann sruthú
chat.stream(), a thugann péirí(response, chunk)ar ais - Is iad
grpc.RpcErrorna hearráidí; déantar athriachtail arUNAVAILABLEgo huathoibríoch, agus is é 27 nóiméad an t-am teorann réamhshocraithe