Vytvorenie prázdnej dávky
Na tejto strane
Aktualizované 2. novembra 2026 na základe dokumentácie xAI: zľava pre dávky je 20 % na spôsobilé textové modely (nie 50 %), príklady využívajú REST API a oficiálny SDK
xai-sdk(client.batch.*; Batch API od xAI nepoužíva formát OpenAI, takže SDK od OpenAI nie je použiteľné) a API Responses má prednosť pred Chat Completions, čo je v xAI zastaraný koncový bod. Zdroje: Batch API · REST referencia · Cenník pre dávky.
Prvý krok: inicializácia
Vytvorenie dávky je prvou konkrétnou akciou vo tvojom pracovnom postupe. Volanie POST /v1/batches inicializuje prázdny kontajner, do ktorého následne pridáš svoje požiadavky. Tento krok je zámerne minimálny: vytvorí identifikátor a pripraví dávku na strane servera.
POST /v1/batches
Vytvorí pomenovanú dávku a vráti jej batch_id.
Uloženie batch_id
Ulož identifikátor pre neskoršie operácie.
Pridanie požiadaviek
Dávka je pripravená prijímať požiadavky prostredníctvom API.
Volanie na vytvorenie
Telo požiadavky obsahuje iba 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"}'
Odozva obsahuje batch_id, dátumy vytvorenia a exspirácie a počítadlá dávky, ktoré sú zatiaľ nulové (príklad z referencie 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
}
}
Implementácia v Pythone
Oficiálny SDK nainštaluješ príkazom pip install xai-sdk (verzia 1.21.0 k 2. novembru 2026; minimálne Python 3.10). Kľúč si načíta z premennej prostredia 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átené batch_id je jedinečnou referenciou pre tvoju dávku. Uchovaj ho v premennej, súbore alebo databáze v závislosti od tvojej architektúry.
Implementácia v JavaScripte
Bez použitia SDK stačí jednoduché volanie 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 rýchlosti vytvárania
Vytváranie dávok je obmedzené na 2 za sekundu na tím; počet samotných dávok nie je obmedzený. V praxi tento limit dosiahneš len zriedka: zvyčajne vytvoríš jednu dávku na operáciu a následne do nej pridáš všetky svoje požiadavky. Ak vytváraš viacero dávok v cykle, rozdeľ volania aspoň na 500 milisekúnd.
Osvedčené postupy
Dávky pomenuj starostlivo: názov je povinný, takže ho využij zmysluplne. Názov, ktorý uvádza dátovú sadu a dátum (customer_reviews_2026_11_02), sa ľahko nájde v zozname dávok aj v konzole xAI, ktorá ti tiež umožňuje vizuálne sledovať dávky.
Všímaj si exspiráciu: expire_time označuje moment, keď prestanú byť dávka a jej výsledky dostupné. Tvoj proces získavania výsledkov sa musí uskutočniť pred týmto časom.
Ošetruj chyby pri vytváraní: vytvoreniu môže zabrániť chyba overenia, prekročenie limitu rýchlosti alebo problém so sieťou. Prechodné chyby opakuj s rastúcim oneskorením (exponenciálne oneskorenie), ale nikdy neopakuj chyby overenia.
Kľúčové poznatky
- Vytvorenie dávky je
POST /v1/batches, kde jediným povinným poľom jename - Odozva obsahuje jedinečné
batch_id, ktoré si musíš uchovať pre zvyšok pracovného postupu - V Pythone oficiálny SDK
xai-sdkposkytuje metóduclient.batch.create(batch_name=...) - Limit sú 2 vytvorenia za sekundu na tím, pričom počet dávok nie je obmedzený
- Sleduj
expire_timea opakuj len prechodné chyby