Python SDK xAI
Na tej strani
Posodobljeno 3. novembra 2026, na podlagi najboljših praks xAI in referenčne dokumentacije API-ja: temperatura omejena na 1, priporočena vrednost 0,7. Vir: Najboljše prakse. Primer klica sledi README datoteki SDK-ja (
chat.append(user(...)),chat.sample(),response.content) in je bil izveden za preverjanje.
Uradni Python SDK xAI
Nativni Python SDK xAI je najbolj neposreden način za delo z API-jem Grok. Razkriva specifične funkcije platforme in prejme posodobitve prvi, ko so dodani novi modeli ali končne točke.
Namestitev
Namesti SDK s pip v svojem Python okolju:
pip install xai-sdk
Priporočamo uporabo virtualnega okolja za izolacijo odvisnosti vsakega projekta:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inicializacija odjemalca
Razred Client je vstopna točka SDK-ja. Upravlja avtentikacijo, HTTP povezave in serializacijo zahtevkov:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Če je spremenljivka okolja XAI_API_KEY nastavljena, lahko odjemalca ustvariš tudi brez eksplicitnega argumenta:
client = Client()
SDK samodejno zazna spremenljivko in jo uporabi za avtentikacijo.
Pošiljanje zahtevka
Ko je odjemalec inicializiran, SDK razmišlja v pogovorih: client.chat.create() ustvari pogovor (brez pošiljanja česar koli), append doda sporočilo, zgrajeno s user() ali system(), sample() pa od modela zahteva odgovor:
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("Razloži, kaj je REST API, v treh stavkih."))
response = chat.sample()
print(response.content)
Pogosti parametri
model: ID modela za uporabo (obvezno); xAI priporočagrok-4.7messages: začetna sporočila pogovora, zgrajena ssystem(),user()inassistant()izxai_sdk.chat(navadni slovarji povzročijo neuspeh klica)temperature: od 0 do 2, nad to vrednostjo omejena na 1; xAI priporoča 0,7, ztop_pnastavljenim na 0,95max_tokens: največje število generiranih žetonovreasoning_effort: globina razmišljanja (none,low,medium,high), ki jo xAI priporoča nastaviti pri vsakem zahtevku
Pretok (streaming) ne poteka prek parametra: for response, chunk in chat.stream(): vrne delčke, ko prispejo, v chunk.content. Lekcija 10 prikazuje pretok z REST API-jem preko SSE.
Prednosti nativnega SDK-ja
V primerjavi z OpenAI SDK, usmerjenim na API xAI (naslednja lekcija), nativni SDK omogoča neposreden dostop do funkcij, specifičnih za xAI: iskanje po X in spletu, orodja na strani strežnika, generiranje videoposnetkov, zbirke dokumentov. Njegovi popolni tipi Python poganjajo samodejno dopolnjevanje v tvojem urejevalniku, xAI pa ga vzdržuje v koraku z API-jem. Ima tudi svojo obliko, ki jo moraš sprejeti: deluje preko gRPC, njegova sporočila so zgrajena s user() in system(), njegove napake pa so grpc.RpcError.
Kdaj izbrati ta SDK
Izbira naravno sledi tvoji situaciji. Za nov projekt, zgrajen specifično na API-ju Grok, je nativni SDK očitna izhodiščna točka: dobiš vse zgoraj navedeno brez potrebe po upoštevanju omejitev združljivosti. Postane bistven takoj, ko načrtuješ uporabo funkcij, specifičnih za xAI, kot sta iskanje po X ali vgrajeno spletno iskanje, ki delujeta v celoti le na ta način. Če pa imaš obstoječo kodo, zgrajeno na OpenAI SDK, trenutno ničesar ne prepisuj: naslednja lekcija prikazuje, kako jo prilagoditi s spremembo dveh vrstic.
Ključne ugotovitve
- Namesti z
pip install xai-sdkv virtualnem okolju - Razred
Clientje vstopna točka s samodejnim zaznavanjemXAI_API_KEY client.chat.create()ustvari pogovor;chat.append(user(...))doda sporočilo,chat.sample()pa vrne odgovor, prebran izresponse.content- Ta SDK raje uporabi za nove projekte, ki ciljajo izključno na API Grok