Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Python SDK od xAI

Lekce 5 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Oficiální Python SDK od xAI
  2. Instalace
  3. Inicializace klienta
  4. Odeslání požadavku
  5. Výhody nativního SDK
  6. Kdy zvolit toto SDK
  7. Klíčové poznatky

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ů.

pip
Standardní instalace
Client
Hlavní třída
Auto
Detekce API klíče
Native
Plná podpora xAI

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čuje grok-4.7
  • messages: počáteční zprávy konverzace, vytvořené pomocí system(), user() a assistant() z xai_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 s top_p nastaveným na 0,95
  • max_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-sdk ve virtuálním prostředí
  • Třída Client je vstupním bodem s automatickou detekcí XAI_API_KEY
  • client.chat.create() vytvoří konverzaci; chat.append(user(...)) přidá zprávu a chat.sample() vrátí odpověď, kterou čteš z response.content
  • Upřednostni toto SDK pro nové projekty cílené výhradně na API Grok