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

Vytvorenie prázdnej dávky

Lekcia 4 z 12 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Prvý krok: inicializácia
  2. Volanie na vytvorenie
  3. Implementácia v Pythone
  4. Implementácia v JavaScripte
  5. Limity rýchlosti vytvárania
  6. Osvedčené postupy
  7. Kľúčové poznatky

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.

1

POST /v1/batches

Vytvorí pomenovanú dávku a vráti jej batch_id.

2

Uloženie batch_id

Ulož identifikátor pre neskoršie operácie.

3

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 je name
  • Odozva obsahuje jedinečné batch_id, ktoré si musíš uchovať pre zvyšok pracovného postupu
  • V Pythone oficiálny SDK xai-sdk poskytuje metódu client.batch.create(batch_name=...)
  • Limit sú 2 vytvorenia za sekundu na tím, pričom počet dávok nie je obmedzený
  • Sleduj expire_time a opakuj len prechodné chyby