Slike in videoposnetki v serijah
Na tej strani
Posodobljeno 2. novembra 2026 na podlagi dokumentacije xAI: popust za serije znaša 20 % za upravičene besedilne modele (ne 50 %), primeri sledijo REST API-ju in uradnemu paketu
xai-sdk(client.batch.*; API za serije xAI ne uporablja formata OpenAI, paket SDK za OpenAI ne velja), API Responses pa ima prednost pred Chat Completions, ki je zastarela končna točka pri xAI. Viri: API za serije · Referenca REST · Cenik za serije.
Večmodalno generiranje na debelo
API za serije ni omejen le na besedilo. Pošiljaš lahko zahteve za generiranje in urejanje slik ter za generiranje, urejanje in podaljševanje videoposnetkov. Ta zmogljivost odpira vrata popolnim večmodalnim cevovodom: v eni sami operaciji napišeš opise in ustvariš njihove vizualne vsebine.
Generiranje slik v serijah
Končna točka /v1/images/generations deluje v seriji enako kot v sinhronem načinu. Format izbereš s parametrom aspect_ratio, ločljivost s parametrom resolution ("1k", "1.5k" ali "2k"), število slik pa s parametrom 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"}}
Urejanje slik v serijah
Končna točka /v1/images/edits spremeni obstoječo sliko, ki jo podaš v objektu image: kot url (javni naslov ali podatki, kodirani v base64) ali kot file_id naložene datoteke.
{"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"}}}
V načinu serije ti urejanje pomaga obdelati katalog: uskladiš ozadja, dodaš element ali uporabiš isto retuš na stotinah vizualnih vsebin.
Generiranje videoposnetkov v serijah
Končna točka /v1/videos/generations (ali /v1/videos) generira videoposnetke v trajanju od 1 do 15 sekund (duration, privzeto 8), v ločljivostih 480p, 720p ali 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"}}
Obdelava videoposnetkov je zahtevnejša od obdelave besedila ali slik, zato lahko ti zahtevki v okviru serije trajajo dlje.
Urejanje in podaljševanje videoposnetkov
Končna točka /v1/videos/edits spremeni obstoječi videoposnetek, končna točka /v1/videos/extensions pa ga podaljša za segment v trajanju od 2 do 10 sekund. Izvorni videoposnetek podaš v objektu video (URL datoteke .mp4 ali 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}}
Uporaba paketa SDK za Python
Paket SDK pripravi te zahtevke z namenskim metodami, nato pa jih doda v serijo tako kot besedilne zahtevke:
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)
Cenik za večmodalne vsebine
Pomembna točka: popust za serije velja samo za upravičene besedilne modele. Slike in videoposnetki se zaračunavajo po standardni tarifi, tudi v načinu serije – od 2. novembra 2026 znaša cena 0,04 USD na sliko z modelom grok-imagine-image-2.0 (0,02 USD z modelom grok-imagine-image) in 0,08 USD na sekundo videoposnetka z modelom grok-imagine-video-1.5 (0,02 USD v različici -lite, 0,05 USD z modelom grok-imagine-video).
Prednost serij za večmodalne vsebine ni v ceni, temveč v operativnosti: v eni sami operaciji pošlješ na stotine generiranj, ne da bi moral upravljati toliko klicev ali naleteti na omejitve hitrosti.
Potek veljavnosti URL-jev rezultatov
Rezultati za slike in videoposnetke so na voljo kot podpisani URL-ji, ki potečejo po eni uri. To je kritična omejitev: datoteke prenesi takoj, ko pridobiš rezultate.
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)
Nikoli ne shranjuj podpisanih URL-jev za kasnejšo uporabo: shrani datoteke v svoje lastno shrambo (S3, GCS, lokalni disk).
Mešani večmodalni cevovod
Konkreten primer uporabe: v isti seriji ustvariš popolne izdelčne liste, besedilne in vizualne:
{"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"}}
Skupna predpona v identifikatorjih (prod-42-desc, prod-42-img) omogoča enostavno združevanje besedilnih in slikovnih rezultatov za isti izdelek.
Ključne ugotovitve
- Slike (generiranje, urejanje) in videoposnetki (generiranje, urejanje, podaljševanje) delujejo v serijah
- Parametri ustrezajo API-ju:
aspect_ratio,resolution, objektaimageinvideo - Slike in videoposnetki ostajajo po standardnih tarifah, brez popustov za serije
- Podpisani URL-ji rezultatov potečejo po eni uri: takojšnji prenos je nujen
- Skupna predpona v identifikatorjih združi rezultate za isti izdelek