grok-imagine-video

Grok Imagine Video vytvára krátke videá podľa textového opisu s výberom dĺžky a pomeru strán. Samotný model spoločnosti xAI podporuje aj animovanie obrázka a cielenú úpravu videa.

Ailoot · Generovanie videa POST /v1/videos/generations grok-imagine-video

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Od opisu k videu

Grok Imagine Video vytvára video z textu. Samotný model spoločnosti xAI má aj režimy so zdrojovým obrázkom a videom. Vo zverejnenej metóde generovania Ailoot slúži ako vstup textový opis a výsledkom je video.

Generovanie prebieha asynchrónne: najprv sa vytvorí úloha, potom sa podľa jej identifikátora získa stav a hotový výsledok. Podľa xAI môže vytvorenie videa trvať niekoľko minút; čas závisí od zložitosti scény, dĺžky, rozlíšenia a zvoleného režimu.

Dĺžka a pomer strán

Pri vytváraní videa je dostupná dĺžka od 1 do 15 sekúnd. Formáty obrazu zahŕňajú 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 a 2:3; predvolený formát je 16:9. Táto verzia poskytuje 480p a 720p, zatiaľ čo 1080p patrí k verzii 1.5.

Animovanie zdrojového obrázka

V režime xAI s obrázkom sa obrázok stáva úvodnou snímkou a textový pokyn určuje pohyb. Predvolene tvar videa kopíruje proporcie zdrojového obrázka. Výslovne nastavený pomer strán mení tento tvar a môže obrázok roztiahnuť.

Cielená úprava

Pri práci s hotovým videom model vykonáva opísané zmeny a zachováva ostatný obsah scény. Tento režim pomáha zmeniť potrebný prvok pri zachovaní inscenácie pôvodného videa. Dĺžka a proporcie sa preberajú z originálu; nová dĺžka ani tvar obrazu sa nenastavujú.

Zdrojové video na úpravu je obmedzené na 8,7 sekundy a výsledok na rozlíšenie najviac 720p. Podklad v 1080p sa zmenší na 720p. Nastavenia generovania z textu sa automaticky neprenášajú na úpravy.

Pokračovanie hotového videa

V osobitnom režime xAI táto verzia pokračuje v zdrojovom videu od jeho poslednej snímky. Zdrojový MP4 musí trvať 2 až 15 sekúnd; pridávaná časť 2 až 10 sekúnd, predvolene 6. Výsledok spája zdrojové video a pokračovanie. Proporcie a rozlíšenie sa preberajú zo zdroja s limitom 720p; v tomto režime ich nemožno meniť osobitne. Táto možnosť výrobcu sa líši od zverejneného generovania Ailoot z textu.

Referenčné obrázky a hranice verzie

xAI poskytuje využitie vizuálnych referenčných obrázkov na usmernenie vzhľadu ľudí, oblečenia a predmetov v scéne. Referenčný obrázok určuje vizuálne znaky, nie presný obraz prvej snímky. Pri klasickom Grok Imagine Video nemožno kombinovať úvodnú snímku s referenčnými obrázkami.

Táto verzia neprijíma presné určenie poslednej snímky ani priebežné kľúčové snímky. Tieto možnosti patria ku Grok Imagine Video 1.5. Generovanie, animovanie zdrojového obrázka a zmena hotového videa sú rôzne režimy; zverejnená metóda Ailoot tu opisuje generovanie z textu.

Ailoot · Generovanie videa POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Úvod

Grok Imagine Video vytvára krátke videá podľa textového opisu s výberom dĺžky a pomeru strán. Samotný model spoločnosti xAI podporuje aj animovanie obrázka a cielenú úpravu videa.

Povolené vstupy: Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot · Generovanie videa POST /v1/videos/generations

Vstup: text
Výstup: video
Výstupný formát: mp4

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity grok-imagine-video	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`duration`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 15 Podmienky: Nezadávajte súčasne duration aj seconds Jednotka: sekundy	Predvolené1
Pole`seconds`	Typ`integer\|integer_string`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 15 Alternatíva: duration	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 480p, 720p	Predvolené480p
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Podmienky: Ak je zadaný vstupný obrázok a pomer strán je vynechaný, poskytovateľ prevezme pomer strán obrázka	Predvolené16:9
Pole`size`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1280x720, 720x1280, 1920x1080, 1080x1920 Podmienky: Musí sa zhodovať s resolution/aspect_ratio, ak sú zadané obe možnosti	Predvolené—
Pole`image`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Skutočný podporovaný vstupný obrázok; umožňuje vynechať zadanie	Predvolené—

Kombinácie vstupných podkladov

Z textu na video · Povinné: prompt

Z obrázka na video · Povinné: image

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`material_types`	Špecifikáciatext
Parameter`required`	Špecifikácianull
Parameter`optional_controls`	Špecifikácianull

Životný cyklus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Štruktúry metód a ID sú presné; možnosti dodávateľa sa posudzujú oddelene od prijatia požiadavky.

Cenník

Sadzby metód Ailoot

Ailoot Generovanie videaPOST /v1/videos/generations

Vstup: 0,002 USD za vstupný obrázok
Vstup: 0,01 USD za sekundu vstupného videa
Výstup: 0,05 USD za sekundu pri 480p
Výstup: 0,07 USD za sekundu pri 720p

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot · Generovanie videa

Príklad videa

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Prijať a uložiť výsledky

Ailoot · Generovanie videa

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Skontrolovať stav úlohy

GET stav

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

Čítanie ďalšieho obsahu

GET obsah

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Zachovajte celý stavový JSON a skutočné request_id. Dokončená odpoveď so status=done obsahuje video.url s URL obsahu vo vašom vlastníctve. Zachovajte nahlásenú dĺžku a každé vrátené pole výsledku.

Ak treba overiť pôvodnú odpoveď

Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.

Polia odpovede

Pole	Typ
Pole`request_id`	Typstring
Pole`id`	Typstring
Pole`status`	Typstring
Pole`video.url`	Typowned signed content URL
Pole`video.duration`	Typnumber
Pole`video.respect_moderation`	Typboolean

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra	Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia.
Odpoveď409 · `video_not_ready`	PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný	Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After.
Odpoveď`server_error`	PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať	Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte.

Aliasy

Aliasy modelov

Ailoot grok-imagine-video

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

grok-imagine-video

FAQ · grok-imagine-video

Aké vstupy a výsledky sú dostupné?: POST /v1/videos/generations · grok-imagine-video: text → video
Aké polia používa požiadavka?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Aké limity platia?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video