Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Vaizdai ir vaizdo įrašai paketuose

Paskaita 9 iš 12 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Masinis daugiamodis generavimas
  2. Paketinis vaizdų generavimas
  3. Paketinis vaizdų redagavimas
  4. Paketinis vaizdo įrašų generavimas
  5. Vaizdo įrašų redagavimas ir pratęsimas
  6. Python SDK naudojimas
  7. Daugiamodžio turinio kainodara
  8. Rezultatų URL galiojimo laikas
  9. Mišrus daugiamodis procesas
  10. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. pagal xAI dokumentaciją: nuolaida paketams yra 20 % tinkamiems teksto modeliams (ne 50 %), pavyzdžiai atitinka REST API ir oficialųjį xai-sdk (client.batch.*; xAI paketų API nenaudoja OpenAI formato, todėl OpenAI SDK netinka), o „Responses“ API turi viršenybę prieš „Chat Completions“, kuris xAI sistemoje yra pasenusi galutinė stotis. Šaltiniai: Paketų API · REST nuoroda · Paketų kainodara.

Masinis daugiamodis generavimas

Paketų API nėra skirtas tik tekstui. Galite pateikti vaizdų generavimo ir redagavimo užklausas, taip pat vaizdo įrašų generavimo, redagavimo ir pratęsimo užklausas. Ši galimybė atveria duris visiems daugiamodžiams procesams: viena operacija parašykite aprašymus ir sukurkite jiems atitinkančius vaizdus.

Paketinis vaizdų generavimas

Galutinė stotis /v1/images/generations veikia paketuose taip pat, kaip ir sinchroniniu režimu. Nustatykite formatą naudodami aspect_ratio, raišką naudodami resolution ("1k", "1.5k" arba "2k") ir vaizdų skaičių naudodami 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"}}

Paketinis vaizdų redagavimas

Galutinė stotis /v1/images/edits modifikuoja esamą vaizdą, perduodamą image objekte: tai gali būti url (viešas adresas arba „base64“ koduotais duomenimis) arba įkeltos failo 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"}}}

Paketiniu režimu redagavimas padeda apdoroti katalogus: suvienodinti fonus, pridėti elementą arba taikyti tą patį retušavimą šimtams vaizdų.

Paketinis vaizdo įrašų generavimas

Galutinė stotis /v1/videos/generations (arba /v1/videos) generuoja nuo 1 iki 15 sekundžių trukmės vaizdo įrašus (duration, pagal nutylėjimą 8), 480p, 720p arba 1080p raiška:

{"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"}}

Vaizdo įrašų apdorojimas reikalauja daugiau išteklių nei tekstas ar vaizdai, todėl šios užklausos pakete gali užtrukti ilgiau.

Vaizdo įrašų redagavimas ir pratęsimas

Galutinė stotis /v1/videos/edits modifikuoja esamą vaizdo įrašą, o /v1/videos/extensions pratęsia jį 2–10 sekundžių segmentu. Šaltinio vaizdo įrašą perduokite video objekte (.mp4 failo URL arba 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}}

Python SDK naudojimas

SDK paruošia šias užklausas naudodama specializuotus metodus, tada prideda jas į paketą taip pat, kaip ir teksto užklausas:

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)

Daugiamodžio turinio kainodara

Svarbus punktas: nuolaida paketams taikoma tik tinkamiems teksto modeliams. Vaizdai ir vaizdo įrašai apmokestinami standartiniu tarifu, net ir paketiniu režimu – 2026 m. lapkričio 2 d. duomenimis, 0,04 USD už vieną vaizdą naudojant grok-imagine-image-2.0 (0,02 USD naudojant grok-imagine-image) ir 0,08 USD už vieną vaizdo įrašo sekundę naudojant grok-imagine-video-1.5 (0,02 USD -lite versijoje, 0,05 USD naudojant grok-imagine-video).

Paketų nauda dirbant su daugiamodžiu turiniu slypi ne kainodaroje, o operaciniuose procesuose: viena operacija galite pateikti šimtus generavimo užklausų, nereikalinga valdyti tiek daug kvietimų ar nerimauti dėl dažnio ribojimų.

Rezultatų URL galiojimo laikas

Vaizdų ir vaizdo įrašų rezultatai pateikiami kaip pasirašyti URL, kurie galioja tik vieną valandą. Tai kritinis apribojimas: atsisiųskite failus iškart, kai tik gausite rezultatus.

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)

Niekada nesaugokite pasirašytų URL vėlesniam naudojimui: išsaugokite failus savo saugykloje (S3, GCS, vietiniame diske).

Mišrus daugiamodis procesas

Konkretus naudojimo atvejis: tame pačiame pakete sukurkite išsamias produkto korteles, apimančias tekstą ir vaizdus:

{"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"}}

Bendras priešdėlis identifikatoriuose (prod-42-desc, prod-42-img) leidžia lengvai sugrupuoti to paties produkto teksto ir vaizdo rezultatus.

Svarbiausi punktai

  • Vaizdai (generavimas, redagavimas) ir vaizdo įrašai (generavimas, redagavimas, pratęsimas) veikia paketiniu režimu
  • Parametrai atitinka API: aspect_ratio, resolution, image ir video objektai
  • Vaizdai ir vaizdo įrašai lieka standartiniu tarifu, be nuolaidų už paketus
  • Pasirašyti rezultatų URL galioja vieną valandą: atsisiųskite iškart
  • Bendras priešdėlis identifikatoriuose sugrupuoja to paties produkto rezultatus