Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Python SDK xAI

Lekcija 5 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Uradni Python SDK xAI
  2. Namestitev
  3. Inicializacija odjemalca
  4. Pošiljanje zahtevka
  5. Prednosti nativnega SDK-ja
  6. Kdaj izbrati ta SDK
  7. Ključne ugotovitve

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.

pip
Standardna namestitev
Odjemalec
Glavni razred
Samodejno
Zaznavanje ključa API
Nativno
Polna podpora xAI

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ča grok-4.7
  • messages: začetna sporočila pogovora, zgrajena s system(), user() in assistant() iz xai_sdk.chat (navadni slovarji povzročijo neuspeh klica)
  • temperature: od 0 do 2, nad to vrednostjo omejena na 1; xAI priporoča 0,7, z top_p nastavljenim na 0,95
  • max_tokens: največje število generiranih žetonov
  • reasoning_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-sdk v virtualnem okolju
  • Razred Client je vstopna točka s samodejnim zaznavanjem XAI_API_KEY
  • client.chat.create() ustvari pogovor; chat.append(user(...)) doda sporočilo, chat.sample() pa vrne odgovor, prebran iz response.content
  • Ta SDK raje uporabi za nove projekte, ki ciljajo izključno na API Grok