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

An SDK Python ó xAI

Ceacht 5 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. SDK oifigiúil Python xAI
  2. Suiteáil
  3. An cliant a thúsú
  4. Iarratas a sheoladh
  5. Buntáistí an SDK dhúchasaigh
  6. Cathin an SDK seo a roghnú
  7. Príomhphointí

Nuashonraithe an 3 Samhain 2026, bunaithe ar dhea-chleachtais xAI agus ar an tagairt API: teocht teoranta ag 1 agus molta ag 0.7. Foinse: Dea-chleachtais. Leanann an sampla glaonna README an SDK (chat.append(user(...)), chat.sample(), response.content) agus rithadh é chun é a fhíorú.

SDK oifigiúil Python xAI

Is é SDK dúchasach Python xAI an bealach is díreach chun oibriú leis an API Grok. Nochtann sé gnéithe sonraithe an ardáin agus faigheann sé nuashonruithe ar dtús nuair a chuirtear múnlaí nó críochphointí nua leis.

pip
Suiteáil chaighdeánach
Cliant
Príomh-aicme
Uathoibríoch
Brath eochair API
Dúchasach
Tacaíocht iomlán xAI

Suiteáil

Suiteáil an SDK le pip i do thimpeallacht Python:

pip install xai-sdk

Molaimid timpeallacht fhíorúil a úsáid chun spleáchais gach tionscadail a scaradh óna chéile:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install xai-sdk

An cliant a thúsú

Is é an aicme Client pointe iontrála an SDK. Déileálann sí le fíordheimhniú, ceangail HTTP, agus sraitheáil iarratas:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))

Má tá an athróg timpeallachta XAI_API_KEY socraithe, is féidir leat an cliant a chruthú gan argóint shainráite:

client = Client()

Braithfidh an SDK an athróg go huathoibríoch agus úsáidfidh sé í le haghaidh fíordheimhniú.

Iarratas a sheoladh

Nuair a bheidh an cliant túsaithe, smaoiníonn an SDK i dtéarmaí comhráiteanna: cruthaíonn client.chat.create() an comhrá (gan aon rud a sheoladh), cuireann append teachtaireacht leis atá tógtha le user() nó system(), agus iarrann sample() ar an múnla a fhreagra a thabhairt:

import os

from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(model="grok-4.7")
chat.append(user("Mínigh cad is API REST ann i 3 abairt."))
response = chat.sample()

print(response.content)

Paraiméadair choitianta

  • model: ID an mhúnla le húsáid (riachtanach); molann xAI grok-4.7
  • messages: teachtaireachtaí tosaigh an chomhrá, tógtha le system(), user(), agus assistant() ó xai_sdk.chat (teipfidh ar an nglao le foclóirí simplí)
  • temperature: ó 0 go 2, teoranta ag 1 os a chionn sin; molann xAI 0.7, le top_p ag 0.95
  • max_tokens: an líon uasta token a ghinfear
  • reasoning_effort: doimhneacht na réasúnaíochta (none, low, medium, high), a mholann xAI a shocrú ar gach iarratas

Ní théann sruthú trí pharaiméadar: filleann for response, chunk in chat.stream(): na blúirí de réir mar a thagann siad isteach i chunk.content. Taispeánann Ceacht 10 sruthú leis an API REST, thar SSE.

Buntáistí an SDK dhúchasaigh

I gcomparáid leis an SDK OpenAI atá dírithe ar an API xAI (an chéad cheacht eile), tugann an SDK dúchasach rochtain dhíreach ar ghnéithe atá sonrach do xAI: cuardach X agus gréasáin, uirlisí taobh freastalaí, giniúint físeáin, bailiúcháin doiciméad. Cumhachtaíonn a chineálacha Python iomlána uathchríochnú d’eagarthóra, agus coinníonn xAI cothrom le dáta é ag luas an API. Tá a chruth féin aige freisin, ar ghlacadh leis: rithíonn sé thar gRPC, tógtar a theachtaireachtaí le user() agus system(), agus is iad grpc.RpcError a chuid earráidí.

Cathin an SDK seo a roghnú

Leanann an rogha go nádúrtha ó do staid. Do thionscadal nua atá tógtha go sonrach ar an API Grok, is é an SDK dúchasach an pointe tosaigh is soiléire: faigheann tú gach rud thuas gan srianta comhoiriúnachta le hurramú. Éiríonn sé riachtanach chomh luath agus a phleanálann tú gnéithe atá sonrach do xAI a úsáid, mar shampla cuardach X nó cuardach gréasáin ionsuite, nach n-oibríonn go hiomlán ach ar an mbealach seo. Má tá cód ann cheana féin agat atá tógtha ar an SDK OpenAI, áfach, ná hathscríobh aon rud faoi láthair: taispeánann an chéad cheacht eile conas é a oiriúnú trí dhá líne a athrú.

Príomhphointí

  • Suiteáil le pip install xai-sdk i dtimpeallacht fhíorúil
  • Is é an aicme Client an pointe iontrála, le brath uathoibríoch ar XAI_API_KEY
  • Cruthaíonn client.chat.create() comhrá; cuireann chat.append(user(...)) teachtaireacht leis, agus filleann chat.sample() an freagra, léite ó response.content
  • Roghnaigh an SDK seo do thionscadail nua a dhíríonn ar an API Grok amháin