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

Obrázky a videá v dávkach

Lekcia 9 z 12 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Hromadná multimodálna generácia
  2. Dávkové generovanie obrázkov
  3. Dávkové úpravy obrázkov
  4. Dávkové generovanie videí
  5. Úpravy a rozširovanie videí
  6. Používanie Python SDK
  7. Ceny za multimodálny obsah
  8. Expirácia URL výsledkov
  9. Zmiešaný multimodálny pipeline
  10. 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, 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, objekty image a video
  • 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