Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Python SDK xAI

Lekcija 5 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Službeni Python SDK tvrtke xAI
  2. Instalacija
  3. Inicijalizacija klijenta
  4. Slanje zahtjeva
  5. Prednosti nativnog SDK-a
  6. Kada odabrati ovaj SDK
  7. Ključne točke

Ažurirano 3. studenog 2026., na temelju najboljih praksi i referenci API-ja tvrtke xAI: temperatura je ograničena na 1, a preporučena vrijednost iznosi 0,7. Izvor: Najbolje prakse. Primjer poziva slijedi SDK README (chat.append(user(...)), chat.sample(), response.content) i pokrenut je radi provjere.

Službeni Python SDK tvrtke xAI

Nativni Python SDK tvrtke xAI najizravniji je način rada s Grok API-jem. Izlaže specifične značajke platforme i prvi dobiva ažuriranja kada se dodaju novi modeli ili krajnje točke.

pip
Standardna instalacija
Klijent
Glavna klasa
Auto
Automatsko otkrivanje API ključa
Nativno
Potpuna podrška za xAI

Instalacija

Instaliraj SDK pomoću alata pip u svom Python okruženju:

pip install xai-sdk

Preporučujemo korištenje virtualnog okruženja kako bi se ovisnosti svakog projekta izolirale:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install xai-sdk

Inicijalizacija klijenta

Klasa Client ulazna je točka SDK-a. Ona upravlja autentifikacijom, HTTP vezama i serializacijom zahtjeva:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))

Ako je postavljena varijabla okruženja XAI_API_KEY, klijenta možeš stvoriti i bez eksplicitnog argumenta:

client = Client()

SDK automatski detektira varijablu i koristi je za autentifikaciju.

Slanje zahtjeva

Nakon inicijalizacije klijenta, SDK razmišlja u terminima razgovora: client.chat.create() stvara razgovor (bez slanja bilo čega), append dodaje poruku izgrađenu pomoću user() ili system(), a sample() traži odgovor od modela:

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("Objasni što je REST API u 3 rečenice."))
response = chat.sample()

print(response.content)

Uobičajeni parametri

  • model: ID modela koji će se koristiti (obavezno); xAI preporučuje grok-4.7
  • messages: početne poruke razgovora, izgrađene pomoću system(), user() i assistant() iz xai_sdk.chat (obični rječnici uzrokovat će neuspjeh poziva)
  • temperature: od 0 do 2, s gornjom granicom na 1; xAI preporučuje 0,7, uz top_p postavljen na 0,95
  • max_tokens: maksimalan broj generiranih tokena
  • reasoning_effort: dubina rezoniranja (none, low, medium, high), koju xAI preporučuje postaviti u svakom zahtjevu

Strujanje (streaming) ne prolazi kroz parametar: for response, chunk in chat.stream(): vraća fragmente kako stižu u chunk.content. Lekcija 10 prikazuje strujanje s REST API-jem putem SSE-a.

Prednosti nativnog SDK-a

U usporedbi s OpenAI SDK-om usmjerenim na xAI API (sljedeća lekcija), nativni SDK omogućuje izravan pristup značajkama specifičnim za xAI: pretraživanje X-a i weba, alati na strani poslužitelja, generiranje videa i zbirke dokumenata. Njegove potpune Python vrste pokreću automatsko dovršavanje u tvojem uređivaču, a xAI ga održava u korak s API-jem. Također ima vlastitu strukturu koju moraš prihvatiti: radi preko gRPC-a, poruke se grade s user() i system(), a greške su tipa grpc.RpcError.

Kada odabrati ovaj SDK

Odabir prirodno proizlazi iz tvoje situacije. Za novi projekt izgrađen specifično na Grok API-ju, nativni SDK očigledan je početni izbor: dobivaš sve navedeno bez potrebe za poštivanjem ograničenja kompatibilnosti. Postaje ključan čim planiraš koristiti značajke specifične za xAI, poput pretraživanja X-a ili ugrađenog web pretraživanja, koje u potpunosti funkcioniraju samo na ovaj način. S druge strane, ako već imaš postojeći kod izgrađen na OpenAI SDK-u, nemoj ništa prepisivati zasad: sljedeća lekcija pokazuje kako ga prilagoditi promjenom dviju linija koda.

Ključne točke

  • Instaliraj s pip install xai-sdk u virtualnom okruženju
  • Klasa Client ulazna je točka s automatskim otkrivanjem XAI_API_KEY
  • client.chat.create() stvara razgovor; chat.append(user(...)) dodaje poruku, a chat.sample() vraća odgovor koji se čita iz response.content
  • Daj prednost ovom SDK-u za nove projekte koji ciljaju isključivo Grok API