Obrázky a videá 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, SDK od OpenAI sa neuplatňuje) a API Responses má prednosť pred Chat Completions, čo je zastaraný koncový bod v xAI. Zdroje: Batch API · REST Referencia · Cenník Batch.
Hromadná multimodálna generácia
Batch API nie je obmedzené len na text. Môžeš odosielať generovanie a úpravy obrázkov, ako aj generovanie, úpravy a rozširovanie videí. Táto schopnosť otvára dvere kompletným multimodálnym pipeline: napíš popisy a vygeneruj k nim vizuály v jednej operácii.
Dávkové generovanie obrázkov
Koncový bod /v1/images/generations funguje v dávke rovnako ako v synchronnom režime. Formát vyberieš pomocou aspect_ratio, rozlíšenie pomocou resolution ("1k", "1.5k" alebo "2k") a počet obrázkov pomocou n:
{"custom_id": "img-001", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a fintech startup, white background, vector style", "n": 1, "aspect_ratio": "1:1", "resolution": "1k"}}
{"custom_id": "img-002", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Isometric illustration of a datacenter", "n": 1, "aspect_ratio": "16:9", "resolution": "1k"}}
Dávkové úpravy obrázkov
Koncový bod /v1/images/edits upravuje existujúci obrázok, ktorý sa odovzdáva v objekte image: buď ako url (verejná adresa alebo údaje zakódované v base64), alebo ako file_id nahraného súboru.
{"custom_id": "edit-001", "method": "POST", "url": "/v1/images/edits", "body": {"model": "grok-imagine-image-2.0", "prompt": "Replace the background with a solid white background", "image": {"url": "https://example.com/photo.jpg"}}}
V dávkovom režime ti úpravy pomôžu spracovať katalóg: zjednotiť pozadia, pridať prvok alebo aplikovať rovnakú retuš na stovky vizuálov.
Dávkové generovanie videí
Koncový bod /v1/videos/generations (alebo /v1/videos) generuje videá s dĺžkou od 1 do 15 sekúnd (duration, predvolené je 8) v rozlíšení 480p, 720p alebo 1080p:
{"custom_id": "vid-001", "method": "POST", "url": "/v1/videos/generations", "body": {"model": "grok-imagine-video-1.5", "prompt": "Smooth animation of a bar chart growing progressively", "duration": 8, "resolution": "720p"}}
Spracovanie videa je náročnejšie ako pri texte alebo obrázkoch, takže tieto požiadavky môžu v rámci dávky trvať dlhšie.
Úpravy a rozširovanie videí
Koncový bod /v1/videos/edits upravuje existujúce video a /v1/videos/extensions ho rozširuje o segment dlhý 2 až 10 sekúnd. Zdrojové video odovzdaj v objekte video (URL súboru .mp4 alebo file_id):
{"custom_id": "vid-edit-001", "method": "POST", "url": "/v1/videos/edits", "body": {"model": "grok-imagine-video", "prompt": "Slow down the scene", "video": {"url": "https://example.com/clip.mp4"}}}
{"custom_id": "vid-ext-001", "method": "POST", "url": "/v1/videos/extensions", "body": {"model": "grok-imagine-video", "prompt": "The camera slowly pulls back and reveals a sunset", "video": {"url": "https://example.com/clip.mp4"}, "duration": 6}}
Používanie Python SDK
SDK pripraví tieto požiadavky pomocou vyhradených metód a potom ich pridá do dávky rovnako ako textové požiadavky:
from xai_sdk import Client
client = Client()
batch = client.batch.create(batch_name="catalog_visuals")
requetes = [
client.image.prepare(
prompt="Product shot of wireless headphones, dark background, studio lighting",
model="grok-imagine-image-2.0",
batch_request_id="prod-42-img",
),
client.video.prepare(
prompt="The headphones rotate slowly on a turntable, dramatic lighting",
model="grok-imagine-video-1.5",
batch_request_id="prod-42-vid",
),
]
client.batch.add(batch_id=batch.batch_id, batch_requests=requetes)
Ceny za multimodálny obsah
Dôležitý bod: zľava pre dávky sa vzťahuje len na spôsobilé textové modely. Obrázky a videá sa fakturujú za štandardnú sadzbu, aj v dávkovom režime – k 2. novembru 2026 je to 0,04 $ za obrázok s modelom grok-imagine-image-2.0 (0,02 $ s grok-imagine-image) a 0,08 $ za sekundu videa s modelom grok-imagine-video-1.5 (0,02 $ vo verzii -lite, 0,05 $ s grok-imagine-video).
Výhodou dávok pre multimodálny obsah nie je cena, ale operatíva: môžeš odoslať stovky generovaní v jednej operácii bez potreby spravovať toľko volaní alebo narážať na limity rýchlosti.
Expirácia URL výsledkov
Výsledky obrázkov a videí sú poskytnuté ako podpísané URL, ktoré expirujú po jednej hodine. Toto je kritické obmedzenie: súbory si stiahni hneď, ako získaš výsledky.
import mimetypes
import requests
def telecharger_medias(resultats, dossier):
"""Downloads images and videos as soon as results are retrieved."""
for r in resultats:
reponse = r.proto.response
if reponse.HasField("image_response"):
url = r.image_response.url
elif reponse.HasField("video_response"):
url = r.video_response.url
else:
continue # text result
fichier = requests.get(url, timeout=120)
fichier.raise_for_status()
type_mime = fichier.headers.get("Content-Type", "").split(";")[0]
extension = mimetypes.guess_extension(type_mime) or ".bin"
with open(f"{dossier}/{r.batch_request_id}{extension}", "wb") as f:
f.write(fichier.content)
Nikdy neukladaj podpísané URL na neskoršie použitie: ulož súbory do vlastného úložiska (S3, GCS, lokálny disk).
Zmiešaný multimodálny pipeline
Konkrétny prípad použitia: vytvorenie kompletných produktových listov, textu aj vizuálu, v tej istej dávke:
{"custom_id": "prod-42-desc", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": "Write a marketing description for a high-end wireless headphone.", "max_output_tokens": 300}}
{"custom_id": "prod-42-img", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Product shot of premium wireless headphones, dark gradient background, studio lighting"}}
Spoločná predpona v identifikátoroch (prod-42-desc, prod-42-img) uľahčuje zoskupenie textových a obrazových výsledkov pre ten istý produkt.
Kľúčové poznatky
- Obrázky (generovanie, úpravy) a videá (generovanie, úpravy, rozširovanie) fungujú v dávkach
- Parametre zodpovedajú API:
aspect_ratio,resolution, objektyimageavideo - Obrázky a videá zostávajú za štandardné sadzby, bez zliav pre dávky
- Podpísané URL výsledkov expirujú po jednej hodine: okamžite ich stiahni
- Spoločná predpona v identifikátoroch zoskupuje výsledky pre ten istý produkt