Koncové body podporované v dávkach
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 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
urlkaž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