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

xAI SDK: client.chat.create

Ceacht 4 as 12 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An SDK dúchasach xAI
  2. Suiteáil agus fíordheimhniú
  3. Comhrá, seachas iarratas
  4. Paraiméadair ghiniúna
  5. Freagraí sruthaithe
  6. Láimhseáil earráidí
  7. Glaonna neamh-chomhthreomhara
  8. Príomhphointí

Nuashraithe an 3 Samhain 2026. Ghlac an leagan roimhe seo leis go n-úsáideadh an xai-sdk comhéadan an OpenAI SDK: teachtaireachtaí mar fhoclóirí, response.choices[0].message.content, an paraiméadar stream=True, agus modúl xai_sdk.errors nach 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 xAI grok-4.7 do gach úsáid.
  • messages: na teachtaireachtaí tosaigh, tógtha le system, user, agus assistant.
  • temperature: Glacann an API le luachanna idir 0 agus 2, ach cuireann xAI teorainn leis ag 1 thairis sin agus molann sé 0.7, le top_p ag 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, ó none go high (agus xhigh ar 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á; cuireann chat.append(user(...)) teachtaireacht leis, agus filleann chat.sample() an freagra, a léitear in response.content
  • Tógtar teachtaireachtaí le system, user, agus assistant ó 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.RpcError na hearráidí; déantar athriachtail ar UNAVAILABLE go huathoibríoch, agus is é 27 nóiméad an t-am teorann réamhshocraithe