L-SDK ta' Python ta' xAI
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026, ibbażat fuq l-aħjar prattiki ta’ xAI u r-referenza tal-API: it-temperatura hija limitata għal 1 u rrakkomandata f’0.7. Sors: Aħjar prattiki. L-eżempju tas-sejħa jsegwi l-README tal-SDK (
chat.append(user(...)),chat.sample(),response.content) u ġie eżegwit biex jiġi vverifikat.
L-SDK uffiċjali ta’ Python ta’ xAI
L-SDK nativ ta’ Python ta’ xAI huwa l-aktar mod dirett biex taħdem mal-API ta’ Grok. Dan jesponi l-karatteristiċi speċifiċi tal-pjattaforma u jirċievi aġġornamenti l-ewwel meta jiżdiedu mudelli jew endpoints ġodda.
Installazzjoni
Installa l-SDK b’pip fl-ambjent ta’ Python tiegħek:
pip install xai-sdk
Nirrakkomandaw li tuża ambjent virtwali biex tiżola d-dipendenzi ta’ kull proġett:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inizjalizza l-klijent
Il-klassi Client hija l-punt tad-dħul tal-SDK. Din timmaniġġja l-awtentikazzjoni, il-konnessjonijiet HTTP, u s-serializzazzjoni tat-talbiet:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Jekk il-varjabbli tal-ambjent XAI_API_KEY tkun issettjata, tista’ toħloq il-klijent mingħajr argument espliċitu:
client = Client()
L-SDK jinduna awtomatikament bil-varjabbli u jużaha għall-awtentikazzjoni.
Ibgħat talba
Ladarba l-klijent ikun inizjalizzat, l-SDK jaħseb f’termini ta’ konversazzjonijiet: client.chat.create() toħloq il-konversazzjoni (mingħajr ma tibgħat xejn), append iżid messaġġ mibni b’user() jew system(), u sample() titlob lill-mudell għat-tweġiba tiegħu:
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("Spjega x'inhi API REST f'3 sentenzi."))
response = chat.sample()
print(response.content)
Parametri komuni
model: l-ID tal-mudell li għandu jintuża (meħtieġ); xAI jirrakkomandagrok-4.7messages: il-messaġġi tal-bidu tal-konversazzjoni, mibnija b’system(),user(), uassistant()minnxai_sdk.chat(dizzjunarji sempliċi jikkawżaw li s-sejħa tfalli)temperature: minn 0 sa 2, limitata għal 1 ‘il fuq minn hekk; xAI jirrakkomanda 0.7, b’top_pf’0.95max_tokens: in-numru massimu ta’ tokens iġġeneratireasoning_effort: il-fond tar-raġunament (none,low,medium,high), li xAI jirrakkomanda li jiġi stabbilit fuq kull talba
L-istriming (streaming) ma jgħaddix minn parametru: for response, chunk in chat.stream(): jirritorna l-frammenti hekk kif jaslu f’chunk.content. Il-lezzjoni 10 turi l-istriming mal-API REST, fuq SSE.
Vantaġġi tal-SDK nativ
Meta mqabbel mal-SDK ta’ OpenAI puntat lejn l-API ta’ xAI (il-lezzjoni li jmiss), l-SDK nativ jagħti aċċess dirett għal karatteristiċi speċifiċi ta’ xAI: it-tiftix fuq X u l-web, għodod fuq is-server, ġenerazzjoni tal-vidjo, u kollezzjonijiet ta’ dokumenti. It-tipi sħaħ ta’ Python tiegħu jsaħħu l-awtokompletament tal-editur tiegħek, u xAI jżommu bl-istess ritmu tal-API. Għandu wkoll il-forma tiegħu stess, li trid taċċetta: jaħdem fuq gRPC, il-messaġġi tiegħu jinbnew b’user() u system(), u l-iżbalji tiegħu huma grpc.RpcError.
Meta tagħżel dan l-SDK
L-għażla tiġi naturalment mis-sitwazzjoni tiegħek. Għal proġett ġdid mibni speċifikament fuq l-API ta’ Grok, l-SDK nativ huwa l-punt tat-tluq ovvju: tikseb kollox hawn fuq mingħajr ebda restrizzjoni ta’ kompatibbiltà li trid tirrispetta. Isir essenzjali hekk kif tibda tippjana li tuża karatteristiċi speċifiċi ta’ xAI bħat-tiftix fuq X jew it-tiftix fuq il-web integrat, li jaħdmu biss bis-sħiħ b’dan il-mod. Jekk, min-naħa l-oħra, għandek kodiċi eżistenti mibni fuq l-SDK ta’ OpenAI, tiktbux mill-ġdid għalissa: il-lezzjoni li jmiss turi kif tadattah billi tbiddel żewġ linji.
Punti Ewlenin
- Installa b’
pip install xai-sdkf’ambjent virtwali - Il-klassi
Clienthija l-punt tad-dħul, b’rilevament awtomatiku ta’XAI_API_KEY client.chat.create()toħloq konversazzjoni;chat.append(user(...))iżid messaġġ, uchat.sample()jirritorna t-tweġiba, moqrija minnresponse.content- Ippreferi dan l-SDK għal proġetti ġodda li jimmiraw biss l-API ta’ Grok