An SDK Python ó xAI
Ar an leathanach seo
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.
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 xAIgrok-4.7messages: teachtaireachtaí tosaigh an chomhrá, tógtha lesystem(),user(), agusassistant()ó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, letop_pag 0.95max_tokens: an líon uasta token a ghinfearreasoning_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-sdki dtimpeallacht fhíorúil - Is é an aicme
Clientan pointe iontrála, le brath uathoibríoch arXAI_API_KEY - Cruthaíonn
client.chat.create()comhrá; cuireannchat.append(user(...))teachtaireacht leis, agus filleannchat.sample()an freagra, léite óresponse.content - Roghnaigh an SDK seo do thionscadail nua a dhíríonn ar an API Grok amháin