Python SDK od xAI
Na této stránce
Aktualizováno 3. listopadu 2026 na základě osvědčených postupů xAI a reference k API: teplota je omezena na hodnotu 1 a doporučuje se nastavení 0,7. Zdroj: Osvědčené postupy. Příklad volání vychází z README SDK (
chat.append(user(...)),chat.sample(),response.content) a byl spuštěn pro ověření funkčnosti.
Oficiální Python SDK od xAI
Nativní Python SDK od xAI je nejpřímější způsob, jak pracovat s API Grok. Poskytuje přístup ke specifickým funkcím platformy a získává aktualizace jako první při přidání nových modelů nebo koncových bodů.
Instalace
Nainstaluj SDK pomocí pip ve svém Python prostředí:
pip install xai-sdk
Doporučujeme používat virtuální prostředí pro izolaci závislostí jednotlivých projektů:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inicializace klienta
Třída Client je vstupním bodem SDK. Stará se o autentizaci, HTTP připojení a serializaci požadavků:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Pokud je nastavena proměnná prostředí XAI_API_KEY, můžeš klienta vytvořit i bez explicitního argumentu:
client = Client()
SDK tuto proměnnou detekuje automaticky a použije ji pro autentizaci.
Odeslání požadavku
Jakmile je klient inicializován, SDK pracuje s konceptem konverzací: client.chat.create() vytvoří konverzaci (aniž by cokoli odeslalo), append přidá zprávu vytvořenou pomocí user() nebo system() a sample() požádá model o odpověď:
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("Vysvětli, co je to REST API, ve třech větách."))
response = chat.sample()
print(response.content)
Běžné parametry
model: ID modelu, který chceš použít (povinné); xAI doporučujegrok-4.7messages: počáteční zprávy konverzace, vytvořené pomocísystem(),user()aassistant()zxai_sdk.chat(prosté slovníky způsobí selhání volání)temperature: od 0 do 2, nad tuto hodnotu je omezena na 1; xAI doporučuje 0,7 stop_pnastaveným na 0,95max_tokens: maximální počet vygenerovaných tokenůreasoning_effort: hloubka uvažování (none,low,medium,high), kterou xAI doporučuje nastavit u každého požadavku
Streamování neprobíhá přes parametr: for response, chunk in chat.stream(): vrací fragmenty, jak přicházejí, v chunk.content. Lekce 10 ukazuje streamování přes REST API pomocí SSE.
Výhody nativního SDK
Ve srovnání se SDK od OpenAI namířeným na API xAI (další lekce) poskytuje nativní SDK přímý přístup k funkcím specifickým pro xAI: vyhledávání na X a na webu, nástroje na straně serveru, generování videa a kolekce dokumentů. Kompletní typy v Pythonu pohánějí automatické doplňování v tvém editoru a xAI jej udržuje v souladu s vývojem API. Má však také svou vlastní strukturu, kterou musíš akceptovat: běží přes gRPC, zprávy se vytvářejí pomocí user() a system() a chyby jsou typu grpc.RpcError.
Kdy zvolit toto SDK
Volba vyplývá přirozeně z tvé situace. Pro nový projekt postavený specificky na API Grok je nativní SDK zřejmým výchozím bodem: získáš všechny výše uvedené výhody bez nutnosti dodržovat omezení kompatibility. Stává se nezbytným, jakmile plánuješ používat funkce specifické pro xAI, jako je vyhledávání na X nebo vestavěné webové vyhledávání, které plně fungují pouze tímto způsobem. Pokud naopak máš existující kód postavený na SDK od OpenAI, zatím nic nepřepisuj: další lekce ukazuje, jak jej upravit změnou dvou řádků.
Klíčové poznatky
- Nainstaluj pomocí
pip install xai-sdkve virtuálním prostředí - Třída
Clientje vstupním bodem s automatickou detekcíXAI_API_KEY client.chat.create()vytvoří konverzaci;chat.append(user(...))přidá zprávu achat.sample()vrátí odpověď, kterou čteš zresponse.content- Upřednostni toto SDK pro nové projekty cílené výhradně na API Grok