Pildid ja videod partiidena
Sellel lehel
Uuendatud 2. novembril 2026 vastavalt xAI dokumentatsioonile: partiisoodustus on sobivate tekst mudelite puhul 20% (mitte 50%), näited järgivad REST API-t ja ametlikku
xai-sdk-d (client.batch.*; xAI Batch API ei kasuta OpenAI vormingut, OpenAI SDK ei kehti) ning Responses API-l on eelis Chat Completionsi ees, mis on xAI-s iganenud lõpp-punkt. Allikad: Batch API · REST viide · Partii hinnakiri.
Mitmemõõtmeline hulgigeneratsioon
Batch API ei piirdu ainult tekstiga. Saad esitada piltide genereerimise ja redigeerimise ning videote genereerimise, redigeerimise ja pikendamise taotlusi. See võimalus avab ukse täielikele mitmemõõtmelistele töövoogudele: kirjuta kirjeldused ja loo nende visuaalid ühe operatsiooniga.
Piltide hulgigeneratsioon
Lõpp-punkt /v1/images/generations töötab partii režiimis täpselt nagu sünkroonses režiimis. Vali formaat parameetriga aspect_ratio, eraldusvõime parameetriga resolution ("1k", "1.5k" või "2k") ja piltide arv parameetriga 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"}}
Piltide hulgiredigeerimine
Lõpp-punkt /v1/images/edits muudab olemasolevat pilti, mis edastatakse image objektina: kas url (avalik aadress või base64-kodeeritud andmed) või üles laaditud faili file_id.
{"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"}}}
Partii režiimis aitab redigeerimine töödelda katalooge: ühtlustada taustu, lisada elemente või rakendada sama järeltöötlust sadadele visuaalidele.
Videote hulgigeneratsioon
Lõpp-punkt /v1/videos/generations (või /v1/videos) genereerib 1–15 sekundi pikkuseid videoid (duration, vaikimisi 8) eraldusvõimega 480p, 720p või 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"}}
Videotöötlus on tekstist või piltidest mahukam, seega võivad need taotlused partii sees kauem aega võtta.
Videote redigeerimine ja pikendamine
Lõpp-punkt /v1/videos/edits muudab olemasolevat videot ja /v1/videos/extensions pikendab seda 2–10 sekundi pikkuse lõiguga. Edasta lähtevideo video objektis (.mp4 faili URL või 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}}
Pythoni SDK kasutamine
SDK valmistab need taotlused ette spetsiaalsete meetoditega ja lisab need seejärel partii nagu tekstitaotlused:
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)
Mitmemõõtmelise sisu hinnakujundus
Oluline punkt: partii soodustus kehtib ainult sobivatele tekst mudelitele. Pilte ja videoid arveldatakse tavahinnaga, isegi partii režiimis – seisuga 2. november 2026 on hind $0.04 pildi kohta mudeliga grok-imagine-image-2.0 ($0.02 mudeliga grok-imagine-image) ja $0.08 video sekundi kohta mudeliga grok-imagine-video-1.5 ($0.02 versioonis -lite, $0.05 mudeliga grok-imagine-video).
Partiide eelis mitmemõõtmelise sisu puhul ei seisne hinnas, vaid operatiivsuses: saad esitada sadu genereerimisi ühe operatsioonina, haldamata sama palju väljakutseid või tabamata kiirusepiiranguid.
Tulemuste URL-ide aegumine
Piltide ja videote tulemused edastatakse allkirjastatud URL-idena, mis aeguvad ühe tunni pärast. See on kriitiline piirang: laadi failid alla kohe, kui tulemused kätte saad.
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)
Ära kunagi salvesta allkirjastatud URL-e hilisemaks kasutamiseks: salvesta failid omaenda salvestusruumi (S3, GCS, kohalik ketas).
Segatud mitmemõõtmeline töövoog
Konkreetne kasutusjuhtum: tooda valmis täielikud tootelehed, tekst ja visuaal, samas partiis:
{"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"}}
Identifikaatorites ühine eesliide (prod-42-desc, prod-42-img) võimaldab hõlpsasti rühmitada sama toote teksti- ja pilditulemused.
Peamised punktid
- Pildid (generatsioon, redigeerimine) ja videod (generatsioon, redigeerimine, pikendamine) töötavad partii režiimis
- Parameetrid vastavad API-le:
aspect_ratio,resolution,imagejavideoobjektid - Pildid ja videod jäävad tavahinnale, ilma partii soodustuseta
- Allkirjastatud tulemuste URL-id aeguvad ühe tunni pärast: laadi need kohe alla
- Identifikaatorites ühine eesliide rühmitab sama toote tulemused