grok-imagine-video-1.5-preview

A Grok Imagine Video 1.5 szövegből készít 1–15 másodperces videókat, 1080p-ben is. Maga a modell képanimációt, vizuális referenciákat, kulcsképkockák beállítását és hangsávot támogat.

Ailoot · Videó POST /v1/videos/generations grok-imagine-video-1.5-preview

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

Videójelenet készítése

A Grok Imagine Video 1.5 az xAI modellje szöveges leírásból és vizuális anyagból történő videógeneráláshoz. Az aktuális Ailoot-metódus szöveges generálást tesz közzé; a modell további módjaival kép animálható, referenciák használhatók, és megadhatók a jelenet támpontként szolgáló képkockái.

Az eredmény aszinkron készül: a feladat létrehozása után az elkészültség az azonosítójával ellenőrizhető. Az xAI szerint a folyamat több percig tarthat a jelenet összetettségétől, az időtartamtól és a felbontástól függően. A feladatazonosító kézhezvétele még nem jelenti, hogy a videó elkészült.

Időtartam, arányok és felbontás

A létrehozott videó 1 és 15 másodperc közötti. Választható az 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 vagy 2:3; szövegnél az alapértelmezés 16:9. Képanimációnál alapértelmezésben megmaradnak a kép arányai.

Szövegből és kezdő képből történő generáláshoz 480p, 720p és 1080p érhető el. Az alapértelmezés 480p; a referenciás mód legfeljebb 720p lehet. Az 1080p nem vihető át minden módra pusztán azért, mert a modell rendelkezik vele.

A megjelenés szabályozása

Referenciás módban az xAI legfeljebb 7 képet fogad. Ezek embereket, tárgyakat, ruhákat és más vizuális jellemzőket adnak meg, a kezdő képkocka rögzítése nélkül. Ez a módszer visszatérő szereplőt tartalmazó jelenetekhez, termékbemutatókhoz és a kívánt megjelenés különböző beállítások közötti megőrzéséhez készült.

Első, utolsó és köztes képkockák

Az 1.5 verzió lehetővé teszi a pontos első képkocka, a pontos utolsó képkocka vagy mindkettő rögzítését. Ha csak az utolsó van megadva, a modell maga készíti el a kezdést, majd eljut a kijelölt képhez. Két megadott határ esetén létrehozza a köztük lévő mozgást; a szöveges utasítás pontosíthatja a mozgást és a kameramunkát.

A videón belüli képsorhoz legfeljebb 4 kulcsképkocka rögzíthető. Mindegyik időpontjának szigorúan a kezdés után és a befejezés előtt kell lennie; az igazítás 1/3 másodperces rácshoz történik. A két, azonos rácspontra kerekedő képkockát a rendszer elutasítja. Ennek elkerülésére legalább 1/3 másodpercet kell hagyni közöttük. Az első és az utolsó képkocka ettől a négy köztes képkockától külön adható meg.

A rögzített képkockák vizuális referenciákkal és előre beállított hangokkal kombinálhatók. Ha legalább egy képkocka rögzített, a szöveges leírás nem kötelező: maga a képsor határozza meg a jelenetet. A kulcsképkockák nem használhatók videószerkesztési móddal együtt. Az xAI e képességei nem jelentik, hogy az Ailoot közzétett szöveges generálásában is elérhetők.

Hang és hangkarakterek

Az elkészített videó alapértelmezésben hangsávot tartalmaz; néma eredmény is rendelkezésre áll. Az xAI hangreferenciás módjában legfeljebb 3 előre beállított hangkarakter választható, amelyek a jelenet beszélő szereplőihez kapcsolhatók.

Saját hangfájl hangmintaként történő átadása nem a modell általános képessége: az xAI ezt külön, kérésre biztosítja. Az előre beállított hangkarakter és a feltöltött hang eltérő bemenettípus.

Működési módok

A szöveges generálás új jelenetet készít; a kezdőkép megadja a jelenet kezdetét; a referenciák a megjelenést irányítják; a rögzített képkockák időbeli vizuális pontokat adnak meg. Minden módnak megvannak a saját korlátai, ezért egyik munkamód beállításai nem vihetők át feltétel nélkül egy másikra.

Ailoot · Videó POST /v1/videos/generations grok-imagine-video-1.5-preview

grok-imagine-video-1.5-preview

xAI /grok-imagine-video-1.5-preview

Kezdő lépések

Elfogadott bemenetek: Szöveg
Eredmények: Videó

Elérhető az Ailootban · bemenetek és metódusok

Ailoot · Videó POST /v1/videos/generations

Bemenet: text
Kimenet: video
Kimeneti formátum: mp4

Mező	Típus	Követelmény	Értékek és korlátok	Alapértelmezett
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok grok-imagine-video-1.5-preview	Alapértelmezett—
Mező`prompt`	Típus`string`	KövetelményOpcionális	Értékek és korlátok Minimális hossz: 1	Alapértelmezett—
Mező`duration`	Típus`integer`	KövetelményOpcionális	Értékek és korlátok Minimum: 1 Maximum: 15 Feltételek: Ne adja meg egyszerre a duration és seconds mezőket Egység: másodperc	Alapértelmezett1
Mező`seconds`	Típus`integer\|integer_string`	KövetelményOpcionális	Értékek és korlátok Minimum: 1 Maximum: 15 Alternatíva: duration	Alapértelmezett—
Mező`resolution`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 480p, 720p, 1080p	Alapértelmezett480p
Mező`aspect_ratio`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Feltételek: Ha képbemenetet ad meg, de képarányt nem, a szolgáltató átveszi a kép képarányát	Alapértelmezett16:9
Mező`size`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 1280x720, 720x1280, 1920x1080, 1080x1920 Feltételek: Egyeznie kell a resolution/aspect_ratio értékével, ha mindkettő meg van adva	Alapértelmezett—
Mező`image`	Típus`object`	KövetelményOpcionális	Értékek és korlátok Feltételek: Tényleges támogatott bemeneti kép; lehetővé teszi a prompt elhagyását	Alapértelmezett—

Bemeneti anyagok kombinációi

Szövegből videó · Kötelező: prompt

Képből videó · Kötelező: image

Metódus paraméterei és életciklusa

Paraméter	Szerződés
Paraméter`material_types`	Szerződéstext
Paraméter`required`	Szerződésnull
Paraméter`optional_controls`	Szerződésnull

Életciklus: 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

A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.

Díjcsomagok

Ailoot-metódusok díjai

Ailoot VideóPOST /v1/videos/generations

Bemenet: 0,01 USD bemeneti képenként
Kimenet: 0,25 USD másodpercenként, 1080p felbontáson
Kimenet: 0,08 USD másodpercenként, 480p felbontáson
Kimenet: 0,14 USD másodpercenként, 720p felbontáson

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot · Videó

Videópélda

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-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Eredmények fogadása és mentése

Ailoot · Videó

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

Feladatállapot ellenőrzése

Állapot lekérése GET-tel

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"

További tartalomlekérések

Tartalom lekérése GET-tel

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

Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.

Őrizze meg a teljes állapot-JSON-t és a tényleges request_id értéket. A status=done állapotú befejezett válasz video.url mezőt tartalmaz egy saját tartalom-URL-címmel. Őrizze meg a közölt időtartamot és minden visszaadott eredménymezőt.

Ha az eredeti választ ellenőrizni kell

A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.

Válaszmezők

Mező	Típus
Mező`request_id`	Típusstring
Mező`id`	Típusstring
Mező`status`	Típusstring
Mező`video.url`	Típusowned signed content URL
Mező`video.duration`	Típusnumber
Mező`video.respect_moderation`	Típusboolean

Hibák és következő lépések

Válasz	Feltétel	Következő lépés
Válasz400 · `invalid_request_error`	FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték	Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt.
Válasz409 · `video_not_ready`	FeltételAz eredeti eredmény tartalma még nem érhető el	Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását.
Válasz`server_error`	FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel	Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést.

Álnevek

Modell álnevei

Ailoot grok-imagine-video-1.5-preview

Metódusútvonalak álnevei

Használja a fent látható metódusútvonalakat.

Kapcsolódó modellazonosítók

grok-imagine-video-1.5-preview

FAQ · grok-imagine-video-1.5-preview

Milyen bemenetek és eredmények érhetők el?: POST /v1/videos/generations · grok-imagine-video-1.5-preview: text → video
Mely mezőket használja a kérés?: POST /v1/videos/generations · grok-imagine-video-1.5-preview: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Milyen korlátok érvényesek?: POST /v1/videos/generations · grok-imagine-video-1.5-preview: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video-1.5-preview