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

Obrázky a videa v dávkách

Lekce 9 z 12 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Hromadná multimodální generace
  2. Dávkové generování obrázků
  3. Dávkové úpravy obrázků
  4. Dávkové generování videí
  5. Úpravy a prodlužování videí
  6. Použití Python SDK
  7. Ceník multimodálního obsahu
  8. Expirace URL výsledků
  9. Smíšená multimodální pipeline
  10. Klíčové poznatky

Aktualizováno 2. listopadu 2026 na základě dokumentace xAI: sleva za dávkové zpracování činí 20 % u způsobilých textových modelů (nikoli 50 %), příklady následují rozhraní REST API a oficiální xai-sdk (client.batch.*; Batch API od xAI nepoužívá formát OpenAI, SDK OpenAI se tedy neaplikuje) a rozhraní Responses API má přednost před Chat Completions, což je u xAI zastaralý koncový bod. Zdroje: Batch API · Reference REST · Ceník dávkového zpracování.

Hromadná multimodální generace

Batch API není omezeno pouze na text. Můžeš odesílat generování a úpravy obrázků, stejně jako generování, úpravy a prodlužování videí. Tato schopnost otevírá dveře kompletním multimodálním pipeline: napiš popisy a vygeneruj k nim vizuály v jediné operaci.

Dávkové generování obrázků

Koncový bod /v1/images/generations funguje v dávce stejně jako v synchronním režimu. Formát vybereš pomocí aspect_ratio, rozlišení pomocí resolution ("1k", "1.5k" nebo "2k") a počet obrázků pomocí 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ázků

Koncový bod /v1/images/edits upravuje existující obrázek, který je předán v objektu image: buď jako url (veřejná adresa nebo data kódovaná v base64), nebo jako file_id nahraného souboru.

{"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ávkovém režimu ti úpravy pomáhají zpracovávat katalogy: sjednotit pozadí, přidat prvek nebo aplikovat stejnou retuš na stovky vizuálů.

Dávkové generování videí

Koncový bod /v1/videos/generations (nebo /v1/videos) generuje videa o délce 1 až 15 sekund (duration, výchozí hodnota 8) v rozlišení 480p, 720p nebo 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"}}

Zpracování videa je náročnější než u textu nebo obrázků, takže tyto požadavky mohou v rámci dávky trvat déle.

Úpravy a prodlužování videí

Koncový bod /v1/videos/edits upravuje existující video a /v1/videos/extensions jej prodlužuje o segment dlouhý 2 až 10 sekund. Zdrojové video předáš v objektu video (URL souboru .mp4 nebo 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žití Python SDK

SDK připraví tyto požadavky pomocí vyhrazených metod a poté je přidá do dávky stejně jako textové požadavky:

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)

Ceník multimodálního obsahu

Důležitý bod: sleva za dávkové zpracování platí pouze pro způsobilé textové modely. Obrázky a videa jsou účtovány za standardní sazbu, a to i v dávkovém režimu – k 2. listopadu 2026 je to 0,04 $ za obrázek s modelem grok-imagine-image-2.0 (0,02 $ s grok-imagine-image) a 0,08 $ za sekundu videa s modelem grok-imagine-video-1.5 (0,02 $ ve verzi -lite, 0,05 $ s grok-imagine-video).

Výhoda dávek pro multimodální obsah nespočívá v ceně, ale v provozní efektivitě: můžeš odeslat stovky generací v jedné operaci, aniž bys musel spravovat tolik jednotlivých volání nebo narážel na limity rychlosti.

Expirace URL výsledků

Výsledky obrázků a videí jsou poskytovány jako podepsané URL, které expirují po jedné hodině. To je kritické omezení: soubory si stáhni okamžitě po získání výsledků.

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 neukládej podepsané URL pro pozdější použití: ulož si soubory do vlastního úložiště (S3, GCS, lokální disk).

Smíšená multimodální pipeline

Konkrétní případ použití: vytvoření kompletních produktových listů, textu i vizuálu, v téže dávce:

{"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"}}

Společná předpona v identifikátorech (prod-42-desc, prod-42-img) usnadňuje seskupení textových a obrazových výsledků pro stejný produkt.

Klíčové poznatky

  • Obrázky (generování, úpravy) i videa (generování, úpravy, prodlužování) fungují v dávkách
  • Parametry odpovídají API: aspect_ratio, resolution, objekty image a video
  • Obrázky a videa zůstávají za standardní sazby, bez dávkových slev
  • Podepsané URL výsledků expirují po jedné hodině: stahuj je okamžitě
  • Společná předpona v identifikátorech seskupuje výsledky pro stejný produkt