grok-imagine-video

A Grok Imagine Video szöveges leírásból készít rövid videókat, választható időtartammal és képformával. Maga az xAI-modell képanimációt és célzott videószerkesztést is támogat.

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

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.

A leírástól a videóig

A Grok Imagine Video szövegből készít videót. Magának az xAI-modellnek eredeti képpel és videóval működő módjai is vannak. Az Ailoot közzétett generálási metódusában a bemenet szöveges leírás, az eredmény pedig videó.

A generálás aszinkron: először létrejön egy feladat, majd annak azonosítójával lekérhető az állapot és a kész eredmény. Az xAI szerint egy videó elkészítése több percig is tarthat; az idő a jelenet összetettségétől, az időtartamtól, a felbontástól és a választott módtól függ.

Időtartam és képkocka

A videó időtartama 1 és 15 másodperc között választható. A képformátumok: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 és 2:3; az alapértelmezés 16:9. Ennél a verziónál 480p és 720p érhető el, az 1080p az 1.5 verzióhoz tartozik.

Az eredeti kép animálása

Az xAI képes módjában a kép lesz a kezdő képkocka, a szöveges utasítás pedig a mozgást adja meg. A videó formája alapértelmezésben az eredeti kép arányait követi. A kifejezetten megadott képarány módosítja ezt a formát, és megnyújthatja a képet.

Célzott szerkesztés

Kész videóval végzett munkánál a modell alkalmazza a leírt változtatásokat, miközben a jelenet többi tartalmát megőrzi. Ez a mód segít a kívánt elem módosításában az eredeti videó beállításának megtartásával. Az időtartam és az arányok az eredetitől öröklődnek; új időtartam vagy képforma nem adható meg.

A szerkesztendő eredeti videó legfeljebb 8,7 másodperc, az eredmény felbontása pedig legfeljebb 720p lehet. Az 1080p anyagot a modell 720p-re kicsinyíti. A szöveges generálás beállításai nem vihetők át automatikusan a szerkesztésre.

Kész videó folytatása

Külön xAI-módban ez a verzió az eredeti videót az utolsó képkockájától folytatja. Az eredeti MP4 hossza 2 és 15 másodperc, a hozzáadott részé 2 és 10 másodperc lehet, alapértelmezésben 6. Az eredmény egyesíti az eredeti videót és a folytatást. Az arányok és a felbontás a forrásból öröklődnek, legfeljebb 720p-ig; ebben a módban külön nem módosíthatók. Ez a gyártói képesség eltér az Ailoot közzétett, szövegből történő generálásától.

Referenciák és a verzió határai

Az xAI vizuális referenciák használatát biztosítja a jelenetben szereplő emberek, ruhák és tárgyak megjelenésének irányítására. A referencia vizuális jellemzőket ad meg, nem a kezdő képkocka pontos képét. A klasszikus Grok Imagine Video esetében kezdő képkocka és referenciák nem kombinálhatók.

Ez a verzió nem fogad pontosan rögzített utolsó képkockát vagy köztes kulcsképkockákat. Ezek a képességek a Grok Imagine Video 1.5-höz tartoznak. A generálás, az eredeti kép animálása és a kész videó módosítása különböző módok; az itt közzétett Ailoot-metódus szöveges generálást ír le.

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

grok-imagine-video

xAI /grok-imagine-video

Kezdő lépések

A Grok Imagine Video szöveges leírásból készít rövid videókat, választható időtartammal és képformával. Maga az xAI-modell képanimációt és célzott videószerkesztést is támogat.

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	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	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,002 USD bemeneti képenként
Bemenet: 0,01 USD bemeneti videómásodpercenként
Kimenet: 0,05 USD másodpercenként, 480p felbontáson
Kimenet: 0,07 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", "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

Metódusútvonalak álnevei

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

Kapcsolódó modellazonosítók

grok-imagine-video

FAQ · grok-imagine-video

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

grok-imagine-video