Imagini și videoclipuri în loturi
Pe această pagină
Actualizat la 2 noiembrie 2026 pe baza documentației xAI: reducerea pentru loturi este de 20% la modelele de text eligibile (nu 50%), exemplele urmează API-ul REST și SDK-ul oficial
xai-sdk(client.batch.*; API-ul Batch xAI nu folosește formatul OpenAI, iar SDK-ul OpenAI nu se aplică), iar API-ul Responses are prioritate față de Chat Completions, un endpoint învechit la xAI. Surse: Batch API · Referință REST · Prețuri Batch.
Generare multimodală în masă
API-ul Batch nu se limitează la text. Puteți trimite generări și editări de imagini, precum și generări, editări și extinderi de videoclipuri. Această capacitate deschide ușa către fluxuri de lucru multimodale complete: scrieți descrieri și produceți elementele vizuale corespunzătoare într-o singură operațiune.
Generare de imagini în lot
Endpoint-ul /v1/images/generations funcționează în lot exact ca în modul sincron. Selectați formatul cu aspect_ratio, definiția cu resolution ("1k", "1.5k" sau "2k") și numărul de imagini cu 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"}}
Editare de imagini în lot
Endpoint-ul /v1/images/edits modifică o imagine existentă, transmisă într-un obiect image: o url (adresă publică sau date codificate base64) sau file_id al unui fișier încărcat.
{"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"}}}
În modul lot, editarea ajută la procesarea unui catalog: uniformizarea fundalurilor, adăugarea unui element sau aplicarea aceleiași retușuri la sute de elemente vizuale.
Generare de videoclipuri în lot
Endpoint-ul /v1/videos/generations (sau /v1/videos) generează videoclipuri de la 1 la 15 secunde (duration, implicit 8), în 480p, 720p sau 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"}}
Procesarea video este mai intensă decât cea a textului sau a imaginilor, astfel încât aceste solicitări pot dura mai mult în cadrul lotului.
Editarea și extinderea videoclipurilor
Endpoint-ul /v1/videos/edits modifică un videoclip existent, iar /v1/videos/extensions îl extinde cu un segment de 2 până la 10 secunde. Transmiteți videoclipul sursă într-un obiect video (URL al unui fișier .mp4 sau 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}}
Utilizarea SDK-ului Python
SDK-ul pregătește aceste solicitări cu metode dedicate, apoi le adaugă la lot la fel ca solicitările de text:
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)
Prețurile pentru conținut multimodal
Punct important: reducerea pentru loturi se aplică doar modelelor de text eligibile. Imaginile și videoclipurile sunt facturate la tariful standard, chiar și în modul lot – la data de 2 noiembrie 2026, 0,04 USD per imagine cu grok-imagine-image-2.0 (0,02 USD cu grok-imagine-image) și 0,08 USD per secundă de video cu grok-imagine-video-1.5 (0,02 USD în versiunea -lite, 0,05 USD cu grok-imagine-video).
Avantajul loturilor pentru conținutul multimodal nu este prețul, ci cel operațional: submiterea a sute de generări într-o singură operațiune, fără a gestiona tot atâtea apeluri sau a atinge limitele de rată.
Expirarea URL-urilor de rezultate
Rezultatele pentru imagini și videoclipuri sunt furnizate ca URL-uri semnate care expiră după o oră. Aceasta este o constrângere critică: descărcați fișierele imediat ce recuperați rezultatele.
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)
Nu stocați niciodată URL-urile semnate pentru utilizare ulterioară: salvați fișierele în propria stocare (S3, GCS, disc local).
Flux de lucru multimodal mixt
Un caz de utilizare concret: produceți fișe complete de produs, text și vizual, în același lot:
{"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"}}
Un prefix comun în identificatori (prod-42-desc, prod-42-img) facilitează gruparea rezultatelor text și imagine pentru același produs.
Puncte cheie
- Imaginile (generare, editare) și videoclipurile (generare, editare, extindere) funcționează în loturi
- Parametrii corespund API-ului:
aspect_ratio,resolution, obiecteleimageșivideo - Imaginile și videoclipurile rămân la tarifele standard, fără reduceri pentru loturi
- URL-urile semnate ale rezultatelor expiră după o oră: descărcați-le imediat
- Un prefix comun în identificatori grupează rezultatele pentru același produs