Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Batches für Bilder und Videos

Lektion 9 von 12 Aktualisiert am 2. November 2026 Entwickler
Auf dieser Seite
  1. Massengenerierung multimodaler Inhalte
  2. Batch-Bildgenerierung
  3. Batch-Bildbearbeitung
  4. Batch-Videogenerierung
  5. Video-Bearbeitung und -Erweiterung
  6. Nutzung des Python-SDK
  7. Preisgestaltung für multimodale Inhalte
  8. Ablaufzeit von Ergebnis-URLs
  9. Gemischte multimodale Pipeline
  10. Kernaussagen

Aktualisiert am 2. November 2026 basierend auf der xAI-Dokumentation: Der Batch-Rabatt gilt nur für berechtigte Textmodelle (nicht 50 %), die Beispiele folgen dem REST-API-Format und dem offiziellen xai-sdk (client.batch.*; die xAI-Batch-API verwendet nicht das OpenAI-Format, das OpenAI-SDK ist nicht anwendbar), und die Responses-API hat Vorrang vor Chat Completions, einem veralteten Endpunkt bei xAI. Quellen: Batch API · REST Reference · Batch Pricing.

Massengenerierung multimodaler Inhalte

Die Batch-API beschränkt sich nicht auf Text. Sie können Bildgenerierungen und -bearbeitungen sowie Videogenerierungen, -bearbeitungen und -erweiterungen einreichen. Diese Möglichkeit öffnet die Tür zu vollständigen multimodalen Pipelines: Verfassen Sie Beschreibungen und erzeugen Sie deren visuelle Darstellungen in einer einzigen Operation.

Batch-Bildgenerierung

Der Endpunkt /v1/images/generations funktioniert im Batch-Modus genauso wie im synchronen Modus. Wählen Sie das Format mit aspect_ratio, die Definition mit resolution ("1k", "1.5k" oder "2k") und die Anzahl der Bilder mit 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"}}

Batch-Bildbearbeitung

Der Endpunkt /v1/images/edits modifiziert ein bestehendes Bild, das in einem image-Objekt übergeben wird: eine url (öffentliche Adresse oder base64-kodierte Daten) oder die file_id eines hochgeladenen Dateis.

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

Im Batch-Modus hilft die Bearbeitung bei der Verarbeitung eines Katalogs: Harmonisieren von Hintergründen, Hinzufügen eines Elements oder Anwenden derselben Retusche auf Hunderte von Bildern.

Batch-Videogenerierung

Der Endpunkt /v1/videos/generations (oder /v1/videos) generiert Videos von 1 bis 15 Sekunden (duration, standardmäßig 8), in 480p, 720p oder 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"}}

Die Videobearbeitung ist aufwändiger als Text- oder Bildbearbeitung, sodass diese Anfragen innerhalb des Batches länger dauern können.

Video-Bearbeitung und -Erweiterung

Der Endpunkt /v1/videos/edits modifiziert ein bestehendes Video, und /v1/videos/extensions erweitert es um einen Abschnitt von 2 bis 10 Sekunden. Geben Sie das Quellvideo in einem video-Objekt an (URL einer .mp4-Datei oder 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}}

Nutzung des Python-SDK

Der SDK bereitet diese Anfragen mit dedizierten Methoden vor und fügt sie dem Batch wie Textanfragen hinzu:

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)

Preisgestaltung für multimodale Inhalte

Wichtiger Punkt: Der Batch-Rabatt gilt nur für berechtigte Textmodelle. Bilder und Videos werden nach dem Standardtarif berechnet, auch im Batch-Modus – Stand 2. November 2026: 0,04 USD pro Bild mit grok-imagine-image-2.0 (0,02 USD mit grok-imagine-image) und 0,08 USD pro Sekunde Video mit grok-imagine-video-1.5 (0,02 USD in der -lite-Version, 0,05 USD mit grok-imagine-video).

Der Vorteil von Batches für multimodale Inhalte liegt nicht in der Preisgestaltung, sondern in der operativen Effizienz:reichen Sie Hunderte von Generierungen in einer einzigen Operation ein, ohne so viele Aufrufe zu verwalten oder Rate Limits zu erreichen.

Ablaufzeit von Ergebnis-URLs

Bilder- und Videergebnisse werden als signierte URLs bereitgestellt, die nach einer Stunde ablaufen. Dies ist eine kritische Einschränkung: Laden Sie die Dateien so schnell herunter, wie Sie die Ergebnisse abrufen.

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)

Speichern Sie signierte URLs niemals für einen späteren Gebrauch: Speichern Sie die Dateien in Ihrem eigenen Speicher (S3, GCS, lokale Festplatte).

Gemischte multimodale Pipeline

Ein konkreter Anwendungsfall: Erzeugen Sie vollständige Produktdatenblätter, Text und Bild, im selben Batch:

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

Ein gemeinsamer Präfix in den Identifikatoren (prod-42-desc, prod-42-img) macht es einfach, Text- und Bildergebnisse für dasselbe Produkt zu gruppieren.

Kernaussagen

  • Bilder (Generierung, Bearbeitung) und Videos (Generierung, Bearbeitung, Erweiterung) funktionieren im Batch-Modus
  • Parameter entsprechen der API: aspect_ratio, resolution, image und video-Objekte
  • Bilder und Videos bleiben beim Standardtarif, ohne Batch-Rabatt
  • Signierte Ergebnis-URLs laufen nach einer Stunde ab: Sofort herunterladen
  • Ein gemeinsamer Präfix in Identifikatoren gruppiert Ergebnisse desselben Produkts