grok-imagine-video

Grok Imagine Video vytváří krátká videa podle textového popisu s volbou délky a formátu obrazu. Samotný model xAI podporuje také animaci obrázku a cílené úpravy videa.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Od popisu k videu

Grok Imagine Video vytváří video z textu. Samotný model xAI má také režimy s výchozím obrázkem a videem. Ve zveřejněné metodě generování Ailoot je vstupem textový popis a výsledkem video.

Generování probíhá asynchronně: nejprve vzniká úloha a následně se podle jejího identifikátoru získává stav a hotový výsledek. Podle xAI může vytvoření videa trvat několik minut; doba závisí na složitosti scény, délce, rozlišení a zvoleném režimu.

Délka a obraz

Pro vytvoření videa je dostupná délka 1 až 15 sekund. Formáty obrazu zahrnují 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 a 2:3; standardním formátem je 16:9. U této verze jsou k dispozici 480p a 720p, zatímco 1080p patří do verze 1.5.

Animace výchozího obrázku

V režimu xAI s obrázkem se obrázek stává počátečním snímkem a textová instrukce zadává pohyb. Ve výchozím nastavení tvar videa odpovídá poměru stran původního obrázku. Výslovně zadaný poměr stran tento tvar mění a může obrázek roztáhnout.

Cílené úpravy

Při práci s hotovým videem model provádí popsané změny při zachování ostatního obsahu scény. Tento režim pomáhá změnit potřebný prvek při zachování inscenace původního videa. Délka a poměr stran se přebírají z originálu; nová délka ani tvar obrazu se nezadávají.

Výchozí video pro úpravy je omezeno na 8,7 sekundy a výsledek na rozlišení nejvýše 720p. Materiál v 1080p se zmenšuje na 720p. Nastavení generování z textu se na úpravy automaticky nepřenášejí.

Pokračování hotového videa

V samostatném režimu xAI tato verze pokračuje ve výchozím videu od jeho posledního snímku. Výchozí MP4 musí trvat 2 až 15 sekund; přidávaná část 2 až 10 sekund, ve výchozím nastavení 6. Výsledek spojuje původní video a pokračování. Poměr stran a rozlišení se přebírají z předlohy s limitem 720p; v tomto režimu je nelze samostatně měnit. Tato schopnost výrobce se liší od zveřejněného generování Ailoot z textu.

Referenční obrázky a hranice verze

xAI nabízí používání vizuálních referenčních obrázků pro usměrnění vzhledu lidí, oblečení a předmětů ve scéně. Referenční obrázek určuje vizuální vlastnosti, nikoli přesný obraz prvního snímku. U klasického Grok Imagine Video nelze kombinovat počáteční snímek s referenčními obrázky.

Tato verze nepřijímá přesné pevné určení posledního snímku ani průběžné klíčové snímky. Tyto schopnosti patří do Grok Imagine Video 1.5. Generování, animace výchozího obrázku a změny hotového videa představují různé režimy; zdejší zveřejněná metoda Ailoot popisuje generování z textu.

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

grok-imagine-video

xAI /grok-imagine-video

Úvod

Grok Imagine Video vytváří krátká videa podle textového popisu s volbou délky a formátu obrazu. Samotný model xAI podporuje také animaci obrázku a cílené úpravy videa.

Přijímané vstupy: Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metody

Ailoot · Tvorba videa POST /v1/videos/generations

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

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity grok-imagine-video	Výchozí—
Pole`prompt`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`duration`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 15 Podmínky: Nezadávejte současně duration a seconds Jednotka: sekundy	Výchozí1
Pole`seconds`	Typ`integer\|integer_string`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 15 Alternativa: duration	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 480p, 720p	Výchozí480p
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Podmínky: Je-li zadán obrázek a vynechán poměr stran, poskytovatel převezme poměr stran obrázku	Výchozí16:9
Pole`size`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1280x720, 720x1280, 1920x1080, 1080x1920 Podmínky: Při současném zadání musí odpovídat resolution/aspect_ratio	Výchozí—
Pole`image`	Typ`object`	PožadavekVolitelné	Hodnoty a limity Podmínky: Skutečný podporovaný vstupní obrázek; umožňuje vynechat textové zadání	Výchozí—

Kombinace vstupních materiálů

Text na video · Povinné: prompt

Obrázek na video · Povinné: image

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`material_types`	Kontrakttext
Parametr`required`	Kontraktnull
Parametr`optional_controls`	Kontraktnull

Ž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

Struktury metod a ID jsou přesné; schopnosti dodavatele jsou oddělené od připuštění požadavku.

Tarify

Sazby metod Ailoot

Ailoot Tvorba videaPOST /v1/videos/generations

Vstup: 0,002 US$ za vstupní obrázek
Vstup: 0,01 US$ za sekundu vstupního videa
Výstup: 0,05 US$ za sekundu v 480p
Výstup: 0,07 US$ za sekundu v 720p

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot · Tvorba videa

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

Přijímání a ukládání výsledků

Ailoot · Tvorba 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

Ověřit stav úlohy

Získat stav pomocí GET

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"

Další načtení obsahu

Získat obsah pomocí GET

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

Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Uchovejte celý stavový JSON a skutečné request_id. Dokončená odpověď se stavem status=done obsahuje video.url s URL obsahu spravovaného službou. Zachovejte uvedenou délku a každé vrácené pole výsledku.

Pokud je nutné ověřit původní odpověď

Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.

Pole odpovědi

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 další kroky

Odpověď	Podmínka	Další krok
Odpověď400 · `invalid_request_error`	PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru	Další krokPřed novým požadavkem na vytvoření opravte uvedená pole.
Odpověď409 · `video_not_ready`	PodmínkaObsah původního výsledku zatím není dostupný	Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After.
Odpověď`server_error`	PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat	Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte.

Aliasy

Aliasy modelu

Ailoot grok-imagine-video

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

grok-imagine-video

FAQ · grok-imagine-video

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos/generations · grok-imagine-video: text → video
Jaká pole požadavek používá?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Jaké limity platí?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video