Vytvoření prázdné dávky
Na této stránce
Aktualizováno 2. listopadu 2026 na základě dokumentace xAI: sleva pro dávky činí 20 % u způsobilých textových modelů (nikoli 50 %), příklady využívají REST API a oficiální SDK
xai-sdk(client.batch.*; Batch API od xAI nepoužívá formát OpenAI, takže SDK od OpenAI není použitelné) a API Responses má přednost před Chat Completions, což je u xAI zastaralý koncový bod. Zdroje: Batch API · Reference REST · Ceník dávek.
První krok: inicializace
Vytvoření dávky je první konkrétní akcí ve tvém pracovním postupu. Volání POST /v1/batches inicializuje prázdný kontejner, do kterého následně přidáš své požadavky. Tento krok je záměrně minimalistický: vytvoří identifikátor a připraví dávku na straně serveru.
POST /v1/batches
Vytvoří pojmenovanou dávku a vrátí její batch_id.
Uložení batch_id
Ulož identifikátor pro pozdější operace.
Přidání požadavků
Dávka je připravena přijímat požadavky prostřednictvím API.
Volání pro vytvoření
Tělo požadavku obsahuje pouze jedno povinné pole, name:
curl -X POST https://api.x.ai/v1/batches \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "customer_review_analysis"}'
Odpověď obsahuje batch_id, data vytvoření a vypršení platnosti a čítače dávky, které jsou stále na nule (příklad z reference API):
{
"batch_id": "batch_1934e8b5-f3dc-45f1-8329-9841b0aee9d8",
"name": "customer_review_analysis",
"create_time": "2025-11-11",
"expire_time": "2025-11-12",
"create_api_key_id": "********-****-****-****-************",
"cancel_time": null,
"cancel_by_xai_message": null,
"state": {
"num_requests": 0,
"num_pending": 0,
"num_success": 0,
"num_error": 0,
"num_cancelled": 0
}
}
Implementace v Pythonu
Oficiální SDK nainstaluješ pomocí pip install xai-sdk (verze 1.21.0 k 2. listopadu 2026; vyžaduje Python 3.10 nebo novější). Klíč si načte z proměnné prostředí XAI_API_KEY:
from xai_sdk import Client
client = Client()
batch = client.batch.create(batch_name="customer_review_analysis")
batch_id = batch.batch_id
print(f"Batch created: {batch_id}")
Vrácené batch_id je jedinečná reference pro tvou dávku. Uchovávej ji v proměnné, souboru nebo databázi v závislosti na své architektuře.
Implementace v JavaScriptu
Bez SDK stačí jednoduchý požadavek fetch na REST API:
const response = await fetch("https://api.x.ai/v1/batches", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.XAI_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({ name: "customer_review_analysis" })
});
const batch = await response.json();
console.log(`Batch created: ${batch.batch_id}`);
Limity rychlosti vytváření
Vytváření dávek je omezeno na 2 požadavky za sekundu na tým; počet samotných dávek není omezen. V praxi tento limit jen zřídka překročíš: obvykle vytvoříš jednu dávku na operaci a poté do ní přidáš všechny své požadavky. Pokud vytváříš více dávek v cyklu, odděl volání alespoň o 500 milisekund.
Doporučené postupy
Pečlivě pojmenovávej své dávky: název je povinný, takže ho využij smysluplně. Název, který uvádí datovou sadu a datum (customer_reviews_2026_11_02), se snadno hledá v seznamu dávek i v konzoli xAI, která ti také umožňuje vizuálně sledovat dávky.
Sleduj vypršení platnosti: expire_time udává, kdy přestane být dávka a její výsledky dostupná. Tvůj proces získávání výsledků musí proběhnout před tímto okamžikem.
Ošetři chyby při vytváření: chyba ověření, překročení limitu rychlosti nebo problém se sítí mohou vytvoření zabránit. Přechodné chyby opakuj s rostoucím zpožděním (exponenciální backoff), ale nikdy neopakuj chyby ověření.
Klíčové poznatky
- Vytvoření dávky je požadavek
POST /v1/batches, jehož jediným povinným polem jename - Odpověď obsahuje jedinečné
batch_id, které si musíš uchovat pro zbytek pracovního postupu - V Pythonu oficiální SDK
xai-sdkzpřístupňuje metoduclient.batch.create(batch_name=...) - Limit činí 2 vytvoření za sekundu na tým, přičemž počet dávek není omezen
- Sleduj
expire_timea opakuj pouze přechodné chyby