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

Vytvoření prázdné dávky

Lekce 4 z 12 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. První krok: inicializace
  2. Volání pro vytvoření
  3. Implementace v Pythonu
  4. Implementace v JavaScriptu
  5. Limity rychlosti vytváření
  6. Doporučené postupy
  7. Klíčové poznatky

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.

1

POST /v1/batches

Vytvoří pojmenovanou dávku a vrátí její batch_id.

2

Uložení batch_id

Ulož identifikátor pro pozdější operace.

3

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 je name
  • Odpověď obsahuje jedinečné batch_id, které si musíš uchovat pro zbytek pracovního postupu
  • V Pythonu oficiální SDK xai-sdk zpřístupňuje metodu client.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_time a opakuj pouze přechodné chyby