Python SDK od xAI
Na tejto strane
Aktualizované 3. novembra 2026 na základe osvedčených postupov xAI a referencie API: teplota je obmedzená na hodnotu 1 a odporúčaná hodnota je 0,7. Zdroj: Osvedčené postupy. Príklad volania nasleduje README SDK (
chat.append(user(...)),chat.sample(),response.content) a bol spustený na overenie funkčnosti.
Oficiálne Python SDK od xAI
Natívne Python SDK od xAI je najpriamejším spôsobom práce s API Grok. Sprístupňuje špecifické funkcie platformy a ako prvé dostáva aktualizácie pri pridávaní nových modelov alebo koncových bodov.
Inštalácia
Nainštaluj SDK pomocou pip vo svojom Python prostredí:
pip install xai-sdk
Odporúčame používať virtuálne prostredie na izoláciu závislostí každého projektu:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inicializácia klienta
Trieda Client je vstupným bodom SDK. Spravuje autentifikáciu, HTTP pripojenia a serializáciu požiadaviek:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Ak je nastavená premenná prostredia XAI_API_KEY, môžeš klienta vytvoriť aj bez explicitného argumentu:
client = Client()
SDK túto premennú automaticky deteguje a použije ju na autentifikáciu.
Odoslanie požiadavky
Po inicializácii klienta SDK pracuje s konverzáciami: client.chat.create() vytvorí konverzáciu (bez odoslania čohokoľvek), append pridá správu vytvorenú pomocou user() alebo system() a sample() požiada model o odpoveď:
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("Vysvetli, čo je REST API, v 3 vetách."))
response = chat.sample()
print(response.content)
Bežné parametre
model: ID modelu, ktorý sa má použiť (povinné); xAI odporúčagrok-4.7messages: počiatočné správy konverzácie, vytvorené pomocousystem(),user()aassistant()zxai_sdk.chat(obyčajné slovníky spôsobia zlyhanie volania)temperature: od 0 do 2, nad touto hodnotou je obmedzená na 1; xAI odporúča 0,7 stop_pnastaveným na 0,95max_tokens: maximálny počet vygenerovaných tokenovreasoning_effort: hĺbka uvažovania (none,low,medium,high), ktorú xAI odporúča nastaviť pri každej požiadavke
Streamovanie neprebieha cez parameter: for response, chunk in chat.stream(): vracia fragmenty prichádzajúce v chunk.content. Lekcia 10 ukazuje streamovanie pomocou REST API cez SSE.
Výhody natívneho SDK
V porovnaní so SDK od OpenAI nasmerovaným na API xAI (ďalšia lekcia) poskytuje natívne SDK priamy prístup k funkciám špecifickým pre xAI: vyhľadávanie na X a webe, nástroje na strane servera, generovanie videa a kolekcie dokumentov. Úplné typy v Pythone využívajú automatické dopĺňanie v tvojom editore a xAI ho udržiava v tempe vývoja API. Má však aj svoju vlastnú štruktúru, ktorú musíš akceptovať: beží cez gRPC, správy sa budujú pomocou user() a system() a chyby sú typu grpc.RpcError.
Kedy zvoliť toto SDK
Voľba prirodzene vyplýva z tvojej situácie. Pre nový projekt postavený špecificky na API Grok je natívne SDK zrejmým východiskovým bodom: získaš všetko vyššie uvedené bez nutnosti dodržiavať obmedzenia kompatibility. Stáva sa nevyhnutným hneď, ako plánuješ používať funkcie špecifické pre xAI, ako je vyhľadávanie na X alebo vstavané webové vyhľadávanie, ktoré fungujú úplne len týmto spôsobom. Ak naopak už máš existujúci kód postavený na SDK od OpenAI, zatiaľ nič neprepisuj: ďalšia lekcia ukazuje, ako ho prispôsobiť zmenou dvoch riadkov.
Kľúčové poznatky
- Nainštaluj pomocou
pip install xai-sdkvo virtuálnom prostredí - Trieda
Clientje vstupným bodom s automatickou detekciouXAI_API_KEY client.chat.create()vytvorí konverzáciu;chat.append(user(...))pridá správu achat.sample()vráti odpoveď, ktorú čítaš zresponse.content- Uprednostni toto SDK pre nové projekty cielené výlučne na API Grok