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

Koncové body podporované v dávkach

Lekcia 3 z 12 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Sedem koncových bodov, jeden pracovný postup
  2. Textové koncové body
  3. Koncové body pre obrázky
  4. Koncové body pre video
  5. Miešanie koncových bodov v dávke
  6. Výber správneho koncového bodu
  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 nasledujú REST API a oficiálny xai-sdk (client.batch.*; Batch API od xAI nepoužíva formát OpenAI, takže SDK od OpenAI sa neuplatňuje) a API Responses má prednosť pred Chat Completions, čo je zastaraná koncová точка v xAI. Zdroje: Batch API · Referencia REST · Cenník pre dávky.

Sedem koncových bodov, jeden pracovný postup

Batch API nie je obmedzené len na generovanie textu. Prijíma sedem koncových bodov pokrývajúcich text, obrázky a video a môžeš ich kombinovať v jednej dávke, aby si vybudoval kompletné multimodálne pipeline v jednej operácii.

Textové koncové body

/v1/responses — API Responses, ktoré xAI odporúča. Poskytuje ti prístup k nástrojom na strane servera (vyhľadávanie na webe, vyhľadávanie na X, vykonávanie kódu, MCP), volaniu funkcií a štruktúrovaným výstupom a ako prvé získava nové funkcie.

/v1/chat/completions — Pôvodná koncová точка pre completions vo formáte OpenAI. xAI ju ponecháva ako zastaranú koncovú точку: stále je užitočná pre existujúci kód napísaný proti nej, ale nový pipeline by mal radšej začať s Responses.

Na spôsobilých modeloch sa 20 % zľava pre dávky vzťahuje na oba koncové body naprieč všetkými typmi tokenov.

Koncové body pre obrázky

/v1/images/generations — Generuje obrázky z promptu. Parametre, ktoré použiješ, sú aspect_ratio (napríklad "16:9"), resolution ("1k", "1.5k" alebo "2k"), n pre počet obrázkov a response_format ("url" alebo "b64_json").

/v1/images/edits — Upravuje existujúci obrázok určený objektom image, ktorý obsahuje url (verejná adresa alebo dáta kódované v base64) alebo file_id nahraného súboru. Užitočné na sériové spúšťanie transformácií cez vizuálny katalóg.

Obrázky sa fakturujú štandardnou sadzbou bez zľavy pre dávky: hodnota dávkovania je tu prevádzková, nie finančná.

Koncové body pre video

/v1/videos/generations (alebo /v1/videos) — Generuje videá z promptu s dĺžkou od 1 do 15 sekúnd (duration, predvolené 8) v rozlíšení 480p, 720p alebo 1080p.

/v1/videos/edits — Upravuje existujúce video odovzdané v objekte video (URL súboru .mp4 alebo file_id).

/v1/videos/extensions — Rozširuje video o nový segment s dĺžkou 2 až 10 sekúnd.

Rovnako ako pri obrázkoch, ceny za video zostávajú v režime dávok na štandardnej sadzbe. Výsledky pre obrázky a video prichádzajú ako podpísané URL, ktoré vypršia po jednej hodine.

Miešanie koncových bodov v dávke

V súbore JSONL každý riadok určuje svoj koncový bod v poli url:

{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}

Týmto spôsobom môžeš generovať popisy svojich produktov a ich vizuály v tej istej dávke.

Výber správneho koncového bodu

  • Responses: predvolená voľba, nevyhnutná hneď, ako potrebuješ nástroje na strane servera, štruktúrované výstupy alebo najnovšie funkcie
  • Chat Completions: kontinuita pre kód už napísaný vo formáte Chat Completions a nič viac
  • Obrázky a video: na sériovú tvorbu vizuálov s vedomím, že nezískajú žiadnu zľavu

Kľúčové poznatky

  • Akceptuje sa sedem koncových bodov: dva pre text, dva pre obrázky, tri pre video
  • Responses je odporúčaný koncový bod; Chat Completions je zastaraný koncový bod v xAI
  • Iba tokeny na spôsobilých textových modeloch získavajú 20 % zľavu
  • Pole url každého riadku JSONL určuje cieľový koncový bod a koncové body je možné v rámci dávky miešať
  • Výsledky pre obrázky a video sú podpísané URL platné jednu hodinu