Koncové body podporované v dávkách
Na této stránce
Aktualizováno 2. listopadu 2026 na základě dokumentace xAI: sleva na dávky činí 20 % u způsobilých textových modelů (nikoli 50 %), příklady se řídí rozhraním REST API a oficiálním
xai-sdk(client.batch.*; Batch API od xAI nepoužívá formát OpenAI, takže SDK OpenAI není použitelné) a rozhraní Responses API má přednost před Chat Completions, což je u xAI zastaralá koncová точка. Zdroje: Batch API · Reference REST · Ceník dávek.
Sedm koncových bodů, jeden pracovní postup
Batch API se neomezuje pouze na generování textu. Přijímá sedm koncových bodů pokrývajících text, obrázky a videa a ty je můžeš v rámci jedné dávky kombinovat, abys vybudoval kompletní multimodální pipeline v jediné operaci.
Textové koncové body
/v1/responses — Rozhraní Responses API, které xAI doporučuje. Poskytuje ti přístup k nástrojům na straně serveru (vyhledávání na webu, vyhledávání na X, spouštění kódu, MCP), volání funkcí a strukturované výstupy a jako první získává nové funkce.
/v1/chat/completions — Původní koncový bod pro dokončování ve formátu OpenAI. xAI jej udržuje jako zastaralý: stále je užitečný pro existující kód napsaný proti němu, ale nové pipeline je lepší stavět rovnou na Responses.
U způsobilých modelů platí 20% sleva na dávky pro oba koncové body a pro všechny typy tokenů.
Koncové body pro obrázky
/v1/images/generations — Generuje obrázky na základě promptu. Parametry, které budeš používat, jsou aspect_ratio (například "16:9"), resolution ("1k", "1.5k" nebo "2k"), n pro počet obrázků a response_format ("url" nebo "b64_json").
/v1/images/edits — Upravuje existující obrázek určený objektem image, který obsahuje url (veřejná adresa nebo data kódovaná v base64) nebo file_id nahraného souboru. Užitečné pro sériové spouštění transformací napříč vizuálním katalogem.
Obrázky jsou fakturovány za standardní sazbu bez slevy na dávky: hodnota dávkového zpracování je zde provozní, nikoli finanční.
Koncové body pro videa
/v1/videos/generations (nebo /v1/videos) — Generuje videa na základě promptu o délce 1 až 15 sekund (duration, výchozí hodnota 8) v rozlišení 480p, 720p nebo 1080p.
/v1/videos/edits — Upravuje existující video předané v objektu video (URL souboru .mp4 nebo file_id).
/v1/videos/extensions — Rozšiřuje video o nový segment o délce 2 až 10 sekund.
Stejně jako u obrázků zůstávají ceny za videa v režimu dávek na standardní sazbě. Výsledky pro obrázky i videa přicházejí jako podepsané URL, která vyprší po jedné hodině.
Kombinování koncových bodů v dávce
V souboru JSONL každý řádek určuje svůj 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 způsobem můžeš generovat popisy svých produktů a jejich vizuály ve stejné dávce.
Výběr správného koncového bodu
- Responses: výchozí volba, nezbytná, jakmile potřebuješ nástroje na straně serveru, strukturované výstupy nebo nejnovější funkce
- Chat Completions: kontinuita pro kód již napsaný ve formátu Chat Completions a nic více
- Obrázky a videa: pro sériovou tvorbu vizuálů s vědomím, že na ně není poskytována sleva
Klíčové poznatky
- Je přijímáno sedm koncových bodů: dva pro text, dva pro obrázky, tři pro videa
- Responses je doporučený koncový bod; Chat Completions je u xAI zastaralý koncový bod
- Sleva 20 % platí pouze pro tokeny na způsobilých textových modelech
- Pole
urlkaždého řádku JSONL určuje cílový koncový bod a koncové body lze v rámci dávky kombinovat - Výsledky pro obrázky a videa jsou podepsané URL platné jednu hodinu