Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Bilder och videor i batchar

Lektion 9 av 12 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Massgenerering av multimodalt innehåll
  2. Batch-generering av bilder
  3. Batch-redigering av bilder
  4. Batch-generering av videor
  5. Redigering och förlängning av videor
  6. Användning av Python SDK
  7. Prissättning för multimodalt innehåll
  8. Upphörande av resultat-URL:er
  9. Blandat multimodalt flöde
  10. Viktiga punkter

Uppdaterat den 2 november 2026 baserat på xAI:s dokumentation: batch-rabatten är 20 % för berättigade textmodeller (inte 50 %), exemplen följer REST API:t och den officiella xai-sdk (client.batch.*; xAI Batch API använder inte OpenAI-formatet, OpenAI SDK gäller inte), och Responses API har företräde framför Chat Completions, som är en föråldrad endpoint hos xAI. Källor: Batch API · REST-referens · Batch-prissättning.

Massgenerering av multimodalt innehåll

Batch API:t är inte begränsat till text. Du kan skicka in begäranden för att generera och redigera bilder samt generera, redigera och förlänga videor. Denna funktion öppnar dörren för kompletta multimodala flöden: skriv beskrivningar och producera motsvarande visuellt innehåll i en enda operation.

Batch-generering av bilder

Endpointen /v1/images/generations fungerar i batch precis som i synkront läge. Välj format med aspect_ratio, upplösning med resolution ("1k", "1.5k" eller "2k") och antal bilder med 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-redigering av bilder

Endpointen /v1/images/edits modifierar en befintlig bild som skickas i ett image-objekt: antingen en url (offentlig adress eller base64-kodad data) eller file_id för en uppladdad fil.

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

I batch-läge hjälper redigering till att bearbeta en katalog: harmonisera bakgrunder, lägga till ett element eller applicera samma retusch på hundratals bilder.

Batch-generering av videor

Endpointen /v1/videos/generations (eller /v1/videos) genererar videor på 1 till 15 sekunder (duration, standardvärdet är 8) i upplösningarna 480p, 720p eller 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"}}

Videobearbetning är tyngre än text eller bilder, så dessa begäranden kan ta längre tid att slutföra inom batchen.

Redigering och förlängning av videor

Endpointen /v1/videos/edits modifierar en befintlig video, och /v1/videos/extensions förlänger den med ett segment på 2 till 10 sekunder. Skicka källvideon i ett video-objekt (URL till en .mp4-fil eller 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}}

Användning av Python SDK

SDK:t förbereder dessa begäranden med dedikerade metoder och lägger sedan till dem i batchen på samma sätt som textbegäranden:

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)

Prissättning för multimodalt innehåll

Viktig punkt: batch-rabatten gäller endast för berättigade textmodeller. Bilder och videor debiteras till standardpris, även i batch-läge – från och med den 2 november 2026 kostar det 0,04 USD per bild med grok-imagine-image-2.0 (0,02 USD med grok-imagine-image) och 0,08 USD per sekund video med grok-imagine-video-1.5 (0,02 USD i -lite-versionen, 0,05 USD med grok-imagine-video).

Fördelen med batchar för multimodalt innehåll ligger inte i prissättningen utan i den operativa effektiviteten: du kan skicka in hundratals genereringar i en enda operation utan att behöva hantera lika många anrop eller stöta på hastighetsbegränsningar.

Upphörande av resultat-URL:er

Bild- och videoresultat levereras som signerade URL:er som upphör att gälla efter en timme. Detta är en kritisk begränsning: ladda ner filerna så snart du hämtar resultaten.

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)

Lagra aldrig signerade URL:er för senare användning: spara filerna i ditt eget lagringssystem (S3, GCS, lokal disk).

Blandat multimodalt flöde

Ett konkret användningsfall: producera kompletta produktblad med både text och bild i samma 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"}}

Ett gemensamt prefix i identifierarna (prod-42-desc, prod-42-img) gör det enkelt att gruppera text- och bildresultat för samma produkt.

Viktiga punkter

  • Bilder (generering, redigering) och videor (generering, redigering, förlängning) fungerar i batchar
  • Parametrarna matchar API:t: aspect_ratio, resolution, image- och video-objekt
  • Bilder och videor debiteras till standardpris utan batch-rabatter
  • Signerade resultat-URL:er upphör efter en timme: ladda ner omedelbart
  • Ett gemensamt prefix i identifierarna grupperar resultat för samma produkt