Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-SDK ta' Python ta' xAI

Lezzjoni 5 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-SDK uffiċjali ta’ Python ta’ xAI
  2. Installazzjoni
  3. Inizjalizza l-klijent
  4. Ibgħat talba
  5. Vantaġġi tal-SDK nativ
  6. Meta tagħżel dan l-SDK
  7. Punti Ewlenin

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.

pip
Installazzjoni standard
Client
Klassi prinċipali
Auto
Rilevament awtomatiku tal-API key
Nattiv
Appoġġ sħiħ ta' xAI

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 jirrakkomanda grok-4.7
  • messages: il-messaġġi tal-bidu tal-konversazzjoni, mibnija b’system(), user(), u assistant() minn xai_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_p f’0.95
  • max_tokens: in-numru massimu ta’ tokens iġġenerati
  • reasoning_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-sdk f’ambjent virtwali
  • Il-klassi Client hija l-punt tad-dħul, b’rilevament awtomatiku ta’ XAI_API_KEY
  • client.chat.create() toħloq konversazzjoni; chat.append(user(...)) iżid messaġġ, u chat.sample() jirritorna t-tweġiba, moqrija minn response.content
  • Ippreferi dan l-SDK għal proġetti ġodda li jimmiraw biss l-API ta’ Grok