grok-imagine-video

Grok Imagine Video kuria trumpus vaizdo įrašus pagal tekstinį aprašymą, leidžia pasirinkti trukmę ir kadro formatą. Pats xAI modelis taip pat palaiko vaizdo animavimą ir kryptingą vaizdo įrašų redagavimą.

Ailoot · Vaizdo įrašai POST /v1/videos/generations grok-imagine-video

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Nuo aprašymo iki vaizdo įrašo

Grok Imagine Video kuria vaizdo įrašus pagal tekstą. Pats xAI modelis taip pat turi režimus su pradiniu vaizdu ir vaizdo įrašu. Paskelbtame Ailoot generavimo metode įvestis yra tekstinis aprašymas, o rezultatas — vaizdo įrašas.

Generavimas vyksta asinchroniškai: iš pradžių sukuriama užduotis, tada pagal jos identifikatorių gaunama būsena ir paruoštas rezultatas. xAI duomenimis, vaizdo įrašo kūrimas gali trukti kelias minutes; laikas priklauso nuo scenos sudėtingumo, trukmės, raiškos ir pasirinkto režimo.

Trukmė ir kadras

Vaizdo įrašui kurti prieinama nuo 1 iki 15 sekundžių trukmė. Kadro formatai apima 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ir 2:3; standartinis formatas — 16:9. Šiai versijai numatytos 480p ir 720p, o 1080p priklauso 1.5 versijai.

Pradinio vaizdo animavimas

xAI režime su vaizdu jis tampa pradiniu kadru, o tekstinė instrukcija nustato judėjimą. Pagal numatymą vaizdo įrašo forma atkartoja pradinio vaizdo proporcijas. Aiškiai nustatytas kraštinių santykis pakeičia šią formą ir gali ištempti vaizdą.

Kryptingas redagavimas

Dirbdamas su paruoštu vaizdo įrašu, modelis atlieka aprašytus pakeitimus, išsaugodamas likusį scenos turinį. Šis režimas padeda pakeisti reikiamą elementą išlaikant pradinio vaizdo įrašo scenos pastatymą. Trukmė ir proporcijos paveldimos iš originalo; nauja trukmė arba kadro forma nenustatomos.

Pradinis redaguojamas vaizdo įrašas ribojamas 8,7 sekundės, o rezultatas — ne didesne kaip 720p raiška. 1080p medžiaga sumažinama iki 720p. Generavimo pagal tekstą nustatymai automatiškai neperkeliami į redagavimą.

Paruošto vaizdo įrašo pratęsimas

Atskiru xAI režimu ši versija pratęsia pradinį vaizdo įrašą nuo paskutinio jo kadro. Pradinis MP4 turi trukti nuo 2 iki 15 sekundžių; pridedama dalis — nuo 2 iki 10 sekundžių, pagal numatymą 6. Rezultatas sujungia pradinį vaizdo įrašą ir tęsinį. Proporcijos ir raiška paveldimos iš pradinio įrašo, taikant 720p ribą; šiame režime jų atskirai keisti negalima. Ši gamintojo galimybė skiriasi nuo paskelbto Ailoot generavimo pagal tekstą.

Pavyzdiniai vaizdai ir versijos ribos

xAI numato pavyzdinių vaizdų naudojimą žmonių, drabužių ir daiktų išvaizdai scenoje nukreipti. Pavyzdinis vaizdas nustato vaizdinius požymius, o ne tikslų pirmojo kadro vaizdą. Klasikiniam Grok Imagine Video negalima sujungti pradinio kadro su pavyzdiniais vaizdais.

Ši versija nepriima tikslaus paskutinio kadro fiksavimo ir tarpinių pagrindinių kadrų. Tokios galimybės priklauso Grok Imagine Video 1.5. Generavimas, pradinio vaizdo animavimas ir paruošto vaizdo įrašo keitimas — skirtingi režimai; paskelbtas Ailoot metodas čia aprašo generavimą pagal tekstą.

Ailoot · Vaizdo įrašai POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Pradžia

Leidžiamos įvestys: Tekstas
Rezultatai: Vaizdo įrašai

Prieinama Ailoot · įvestys ir metodai

Ailoot · Vaizdo įrašai POST /v1/videos/generations

Įvestis: text
Išvestis: video
Išvesties formatas: mp4

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos grok-imagine-video	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`duration`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 15 Sąlygos: Nepateikite duration ir seconds kartu Vienetas: sekundės	Numatyta1
Laukas`seconds`	Tipas`integer\|integer_string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 15 Alternatyva: duration	Numatyta—
Laukas`resolution`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 480p, 720p	Numatyta480p
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Sąlygos: Jei pateiktas įvesties paveikslėlis, o kraštinių santykis nenurodytas, teikėjas perima paveikslėlio kraštinių santykį	Numatyta16:9
Laukas`size`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1280x720, 720x1280, 1920x1080, 1080x1920 Sąlygos: Turi atitikti resolution/aspect_ratio, jei nurodyti abu	Numatyta—
Laukas`image`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Tikras palaikomas įvesties paveikslėlis; leidžia nepateikti tekstinės užklausos	Numatyta—

Įvesties medžiagos deriniai

Iš teksto į vaizdo įrašą · Privaloma: prompt

Iš vaizdo į vaizdo įrašą · Privaloma: image

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`material_types`	Specifikacijatext
Parametras`required`	Specifikacijanull
Parametras`optional_controls`	Specifikacijanull

Gyvavimo ciklas: 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

Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.

Planai

Ailoot metodų įkainiai

Ailoot Vaizdo įrašaiPOST /v1/videos/generations

Įvestis: 0,002 USD už įvesties vaizdą
Įvestis: 0,01 USD už įvesties vaizdo įrašo sekundę
Išvestis: 0,05 USD už sekundę 480p raiška
Išvestis: 0,07 USD už sekundę 720p raiška

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot · Vaizdo įrašai

Vaizdo įrašo pavyzdys

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."}'

Gauti ir išsaugoti rezultatus

Ailoot · Vaizdo įrašai

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

Tikrinti užduoties būseną

GET būsena

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"

Kito turinio skaitymas

GET turinys

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

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.

Išsaugokite visą būsenos JSON ir tikrąjį request_id. Užbaigto atsakymo su status=done lauke video.url yra jums priklausančio turinio URL. Išsaugokite nurodytą trukmę ir kiekvieną grąžintą rezultato lauką.

Jei reikia patikrinti pradinį atsakymą

Skaitykite esamos pradinės užduoties duomenis; niekada nekartokite siuntimo, kurio baigtis nežinoma.

Atsakymo laukai

Laukas	Tipas
Laukas`request_id`	Tipasstring
Laukas`id`	Tipasstring
Laukas`status`	Tipasstring
Laukas`video.url`	Tipasowned signed content URL
Laukas`video.duration`	Tipasnumber
Laukas`video.respect_moderation`	Tipasboolean

Klaidos ir tolesni veiksmai

Atsakymas	Sąlyga	Kitas žingsnis
Atsakymas400 · `invalid_request_error`	SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė	Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus.
Atsakymas409 · `video_not_ready`	SąlygaPradinio rezultato turinys dar nepasiekiamas	Kitas žingsnisPeriodiškai tikrinkite pradinį grąžintą ID ir laikykitės Retry-After.
Atsakymas`server_error`	SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti	Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite.

Pseudonimai

Modelių pseudonimai

Ailoot grok-imagine-video

Metodų kelių pseudonimai

Naudokite aukščiau nurodytus metodų kelius.

Susiję ID iškvietimui

grok-imagine-video

FAQ · grok-imagine-video

Kokios įvestys ir rezultatai prieinami?: POST /v1/videos/generations · grok-imagine-video: text → video
Kokius laukus naudoja užklausa?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Kokie apribojimai taikomi?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video