Python SDK xAI
Na ovoj stranici
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.
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čujegrok-4.7messages: početne poruke razgovora, izgrađene pomoćusystem(),user()iassistant()izxai_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, uztop_ppostavljen na 0,95max_tokens: maksimalan broj generiranih tokenareasoning_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-sdku virtualnom okruženju - Klasa
Clientulazna je točka s automatskim otkrivanjemXAI_API_KEY client.chat.create()stvara razgovor;chat.append(user(...))dodaje poruku, achat.sample()vraća odgovor koji se čita izresponse.content- Daj prednost ovom SDK-u za nove projekte koji ciljaju isključivo Grok API