Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Afbeeldingen en video's in batches

Les 9 van 12 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. Multimodale generatie in bulk
  2. Batch-generatie van afbeeldingen
  3. Batch-bewerking van afbeeldingen
  4. Batch-generatie van video’s
  5. Videobewerking en -verlenging
  6. Gebruik van de Python SDK
  7. Prijzen voor multimodale content
  8. Verloop van resultaat-URL’s
  9. Gemengde multimodale pipeline
  10. Belangrijkste punten

Bijgewerkt op 2 november 2026 op basis van de xAI-documentatie: de batch-korting bedraagt 20% voor in aanmerking komende tekstmodellen (niet 50%), de voorbeelden volgen de REST API en de officiële xai-sdk (client.batch.*; de xAI Batch API gebruikt niet het OpenAI-formaat, de OpenAI SDK is niet van toepassing), en de Responses API heeft voorrang boven Chat Completions, een verouderd endpoint bij xAI. Bronnen: Batch API · REST Reference · Batch Pricing.

Multimodale generatie in bulk

De Batch API is niet beperkt tot tekst. U kunt generatie en bewerking van afbeeldingen indienen, evenals generatie, bewerking en verlenging van video’s. Deze mogelijkheid opent de deur naar complete multimodale pipelines: schrijf beschrijvingen en produceer de bijbehorende visuals in één enkele operatie.

Batch-generatie van afbeeldingen

Het endpoint /v1/images/generations werkt in een batch net zoals in synchrone modus. Selecteer het formaat met aspect_ratio, de definitie met resolution ("1k", "1.5k" of "2k"), en het aantal afbeeldingen met 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-bewerking van afbeeldingen

Het endpoint /v1/images/edits wijzigt een bestaande afbeelding, doorgegeven in een image-object: een url (openbaar adres of base64-gecodeerde gegevens) of de file_id van een geüpload bestand.

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

In batch-modus helpt bewerken bij het verwerken van een catalogus: achtergronden harmoniseren, een element toevoegen of dezelfde retouche toepassen op honderden visuals.

Batch-generatie van video’s

Het endpoint /v1/videos/generations (of /v1/videos) genereert video’s van 1 tot 15 seconden (duration, standaard 8), in 480p, 720p of 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"}}

Videoverwerking is zwaarder dan tekst of afbeeldingen, dus deze verzoeken kunnen langer duren binnen de batch.

Videobewerking en -verlenging

Het endpoint /v1/videos/edits wijzigt een bestaande video, en /v1/videos/extensions verlengt deze met een segment van 2 tot 10 seconden. Geef de bronvideo door in een video-object (URL van een .mp4-bestand, of 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}}

Gebruik van de Python SDK

De SDK bereidt deze verzoeken voor met toegewijde methoden en voegt ze vervolgens toe aan de batch, net als tekstverzoeken:

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)

Prijzen voor multimodale content

Belangrijk punt: de batch-korting is alleen van toepassing op in aanmerking komende tekstmodellen. Afbeeldingen en video’s worden gefactureerd tegen het standaardtarief, zelfs in batch-modus—per 2 november 2026 is dat $0,04 per afbeelding met grok-imagine-image-2.0 ($0,02 met grok-imagine-image), en $0,08 per seconde video met grok-imagine-video-1.5 ($0,02 in de -lite-versie, $0,05 met grok-imagine-video).

Het voordeel van batches voor multimodale content ligt niet in de prijs, maar in de operationele efficiëntie: dien honderden generaties in in één operatie, zonder evenveel calls te beheren of tegen tarieflimieten aan te lopen.

Verloop van resultaat-URL’s

Resultaten van afbeeldingen en video’s worden geleverd als ondertekende URL’s die na één uur verlopen. Dit is een kritieke beperking: download de bestanden zodra u de resultaten ophaalt.

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)

Sla nooit ondertekende URL’s op voor later gebruik: bewaar de bestanden in uw eigen opslag (S3, GCS, lokale schijf).

Gemengde multimodale pipeline

Een concreet gebruiksscenario: produceer complete productfiches, tekst en visueel, in dezelfde 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"}}

Een gemeenschappelijk prefix in de identificatoren (prod-42-desc, prod-42-img) maakt het eenvoudig om tekst- en afbeeldingsresultaten voor hetzelfde product te groeperen.

Belangrijkste punten

  • Afbeeldingen (generatie, bewerking) en video’s (generatie, bewerking, verlenging) werken in batches
  • Parameters komen overeen met de API: aspect_ratio, resolution, image- en video-objecten
  • Afbeeldingen en video’s blijven tegen standaardtarieven, zonder batch-kortingen
  • Ondertekende resultaat-URL’s verlopen na één uur: download direct
  • Een gemeenschappelijk prefix in identificatoren groepeert resultaten voor hetzelfde product