Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Slike in videoposnetki v serijah

Lekcija 9 od 12 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Večmodalno generiranje na debelo
  2. Generiranje slik v serijah
  3. Urejanje slik v serijah
  4. Generiranje videoposnetkov v serijah
  5. Urejanje in podaljševanje videoposnetkov
  6. Uporaba paketa SDK za Python
  7. Cenik za večmodalne vsebine
  8. Potek veljavnosti URL-jev rezultatov
  9. Mešani večmodalni cevovod
  10. Ključne ugotovitve

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, objekta image in video
  • 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