Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Python SDK od xAI

Lekcia 5 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Oficiálne Python SDK od xAI
  2. Inštalácia
  3. Inicializácia klienta
  4. Odoslanie požiadavky
  5. Výhody natívneho SDK
  6. Kedy zvoliť toto SDK
  7. Kľúčové poznatky

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.

pip
Štandardná inštalácia
Client
Hlavná trieda
Auto
Detekcia API kľúča
Native
Plná podpora xAI

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úča grok-4.7
  • messages: počiatočné správy konverzácie, vytvorené pomocou system(), user() a assistant() z xai_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 s top_p nastaveným na 0,95
  • max_tokens: maximálny počet vygenerovaných tokenov
  • reasoning_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-sdk vo virtuálnom prostredí
  • Trieda Client je vstupným bodom s automatickou detekciou XAI_API_KEY
  • client.chat.create() vytvorí konverzáciu; chat.append(user(...)) pridá správu a chat.sample() vráti odpoveď, ktorú čítaš z response.content
  • Uprednostni toto SDK pre nové projekty cielené výlučne na API Grok