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

Koncové body podporované v dávkách

Lekce 3 z 12 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Sedm koncových bodů, jeden pracovní postup
  2. Textové koncové body
  3. Koncové body pro obrázky
  4. Koncové body pro videa
  5. Kombinování koncových bodů v dávce
  6. Výběr správného koncového bodu
  7. Klíčové poznatky

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 url kaž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