Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Pildid ja videod partiidena

Õppetund 9 / 12 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Mitmemõõtmeline hulgigeneratsioon
  2. Piltide hulgigeneratsioon
  3. Piltide hulgiredigeerimine
  4. Videote hulgigeneratsioon
  5. Videote redigeerimine ja pikendamine
  6. Pythoni SDK kasutamine
  7. Mitmemõõtmelise sisu hinnakujundus
  8. Tulemuste URL-ide aegumine
  9. Segatud mitmemõõtmeline töövoog
  10. Peamised punktid

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, image ja video objektid
  • 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