SpaceXAI: Grok Imagine Video 1.5

Grok Imagine Video 1.5 vytváří krátká videa se synchronizovaným zvukem z textu, počátečního obrázku nebo vizuálních referencí. Nabízí nativní generování videa z textu či obrázku v 1080p, až 14 referenčních obrázků a tři přednastavené hlasy i ovládání prvních, posledních a mezilehlých snímků pro scény postav a produktů.

Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video-1.5

O modelu

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

Grok Imagine Video 1.5 je plná generovací verze rodiny videomodelů Grok Imagine. Výrobce zdůrazňuje pohyb, fyzickou návaznost a zvukové efekty, atmosféru i řeč generované společně s obrazem. Převod textu a obrázku na video vykresluje v nativním 1080p, zatímco generování vedené referencemi poskytuje více ovládání nad tím, kdo nebo co se ve scéně objeví. Užitečným výsledkem je krátké video se zvukem, například produktová prezentace, rozhovor postav nebo přesně inscenovaný přechod mezi vizuálními kotvami.

U převodu textu na video popište objekt záběru, prostředí, akci, pohyb kamery, osvětlení a zvuk. Výrobce vysvětluje, že 1.5 interně generuje počáteční obrázek a potom jej animuje; mezilehlý obrázek se nevrací. U převodu obrázku na video se dodaný obrázek stává prvním snímkem a prompt popisuje, co se děje dál. Připravte obrázek s již přítomným požadovaným rámováním a viditelnými detaily. Výsledný klip sleduje poměr stran zdrojového obrázku, takže vertikální dodání potřebuje vhodný počáteční ořez.

Převod referencí na video dává obrázkům jinou roli: vedou osoby, předměty, oblečení nebo místa, aniž by automaticky určovaly úvodní snímek. Dokumentovaný limit je až 14 referenčních obrázků s výstupem do 15 sekund při 720p. Každému obrázku přiřaďte jasnou roli ve scéně a identifikujte jej pozicí v seznamu referencí. V syntaxi promptu výrobce je první reference <IMAGE_0>, následuje <IMAGE_1> a tak dále. Je-li ukotven také úvodní obrázek, zabírá první index a samostatné reference začínají následujícím. Toto pořadí je důležité, rozlišuje-li zadání osobu, produkt a prostředí.

Původní referenční zadání může umístit postavu vedle židle dodané na jednom obrázku do místnosti dodané na druhém, s pomalým přiblížením k detailu materiálu židle. Objekt i hlavní produkt udržujte v referencích snadno rozlišitelné. Výrobce doporučuje dát každé referenci jednu roli a pevné místo, při mnoha vstupech ponechat malé obsazení a statické rekvizity. Ověřte, zda se do scény přenesou tvar a označení zamýšleného předmětu a zda kamera odhalí detail požadovaný zadáním.

Převod referencí na video může přiřadit také až tři přednastavené hlasy. V promptu identifikujte zamýšleného mluvčího a jeho hlas samostatně pomocí dokumentovaných pozičních hlasových referencí a dodejte přesný dialog, který má vyslovit. Model podporuje řeč se synchronizací rtů. U krátkého rozhovoru napište repliky nechávající prostor pro odpověď a ve výsledném klipu zkontrolujte přiřazení mluvčích i pohyb úst. Hlasová reference vybírá mluvící identitu; kamerové a scénické pokyny stále musí popsat zobrazení postav.

Ovládání prvního a posledního snímku ukotvuje koncové body záběru a až čtyři klíčové snímky mohou ukotvit obrázky v mezilehlých časech. Příručka klíčových snímků výrobce umisťuje tyto časy přísně dovnitř klipu na mřížce po jedné třetině sekundy; dvě kotvy přiřazené stejnému časovému slotu se odmítají. Připravte kotvy patřící do stejné scény a popište pohyb mezi nimi. U odhalení produktu může úvod ukázat zavřenou vitrínu a konečný snímek odhalený předmět. U smyčky může stejný obrázek sloužit jako první i poslední snímek. Přechod sledujte a poslouchejte celý, místo posuzování pouze ukotvených obrázků.

Běžný převod textu a obrázku na video podporuje klipy 1–15 sekund a výstup 480p, 720p nebo nativní 1080p. Převod referencí na video je omezen na 720p. Textově řízené rámování zahrnuje 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 a 5:2. Délku a tvar zvolte podle akce a cílového použití. Výrobce ve výchozím nastavení generuje zvuk a dokumentuje možnost tichého videa. Zadání může určit mluvenou repliku, blízké efekty a vzdálenou atmosféru, aby zvuk přispíval ke stejné scéně, místo aby byl neurčeným pozadím.

Dokumentovaný postup generování je asynchronní: vrací identifikátor požadavku a potom dokončený výsledek s umístěním klipu a délkou. Příklad výsledku odkazuje na video MP4 a jeho hostované výstupní umístění je dočasné. Při přípravě střihu uchovejte dokončený klip i vstupní zadání. Návaznost, trvalou přítomnost předmětů, pohyb, rámování a zvuk kontrolujte proti zamýšlenému záběru. Mezilehlý záznam zpracování je užitečný pro sledování práce, zatímco přehratelné video je výstupem ke kontrole.

Rozdíly verzí ovlivňují plán. Lite zpracovává přímočarou animaci z textu nebo jednoho obrázku s možností 1080p zvětšenou ze 720p. Plná 1.5 přidává referenční obrázky, přednastavené hlasy a ukotvené snímky. Klasická verze Grok Imagine Video poskytuje úpravy a prodlužování existujících videí. Samostatné údaje vydání o rychlosti Video 1.5 Fast se týkají této pojmenované varianty, a neurčují tedy pevnou dobu dokončení pro tento model. U delší sekvence inscenujte souvislé krátké záběry a při skládání klipů kontrolujte návaznost postavy, produktu a zvuku.

Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video-1.5

x-ai/grok-imagine-video-1.5

SpaceXAI /x-ai/grok-imagine-video-1.5

Úvod

Přijímané vstupy: Text · Obrázky
Výsledky: Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Video POST /v1/videos

Vstup: text, image
Výstup: video
Výstupní formát: původní bajty MP4; bez normalizace a překódování

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity x-ai/grok-imagine-video-1.5	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity	Výchozí—
Pole`duration`	Typ`integer`	PožadavekPovinné	Hodnoty a limity 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 480p, 720p, 1080p	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3	Výchozí—
Pole`generate_audio`	Typ`boolean`	PožadavekVolitelné	Hodnoty a limity false	Výchozí—
Pole`frame_images`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image_url, frame_type Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images.	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`callback_url`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Vzor: ^https://	Výchozí—
Pole`session_id`	Typ`string`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`trace`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`user`	Typ`string`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Kombinace vstupních materiálů

Text na video · Textové zadání. · Povinné: model, prompt, duration

Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.

model: Typ: string · x-ai/grok-imagine-video-1.5

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images

frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Zvolte podporované rozlišení a případně poměr stran.

Přesné klíče: type, image_url, frame_type

model: Typ: string · x-ai/grok-imagine-video-1.5

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt, duration
Parametr`material_types`	Kontrakttext, image
Parametr`additional_properties`	Kontraktfalse
Parametr`optional_controls`	Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Životní cyklus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Podmínky účtování	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Podmínky účtování—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceVstupní obrázek	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza obrázek	Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.	Poplatek Vstup · Vstupní obrázek · Odhad pouze pro srovnání $0.02 za obrázek
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníresolution: 1080p	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.5 za sekundu videa
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníresolution: 480p	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.16 za sekundu videa
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníresolution: 720p	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.28 za sekundu videa
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Podmínky účtování—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.16 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

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í →

Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové reference konfigurací videa

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Podmínky účtování	Poplatek
KonfiguraceVstupní obrázek	Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.	Poplatek Vstup · Vstupní obrázek $0.02 za obrázek Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtováníresolution: 480p	Poplatek Výstup · Cena videa $0.16 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtováníresolution: 720p	Poplatek Výstup · Cena videa $0.28 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtováníresolution: 1080p	Poplatek Výstup · Cena videa $0.5 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.

Příklady požadavků

Ailoot Ultra · Video

curl · vytvořte video

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"x-ai/grok-imagine-video-1.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

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

Ailoot Ultra · Video

podepsané URL obsahu spravovaného službou

GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content

Ověřit stav úlohy

Získat stav původní operace pomocí GET

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Další načtení obsahu

Uložte každý dokončený výstup, který vám patří

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

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 každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.

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

503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte

Pole odpovědi

Pole	Typ	Význam
Pole`index`	Typinteger	VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly.
Pole`content_url`	Typstring	VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa.
Pole`sha256`	Typstring \| null	VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný.
Pole`size_bytes`	Typinteger \| null	VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná.
Pole`duration_ms`	Typinteger \| null	VýznamNaměřená délka videa v milisekundách; null, není-li dostupná.
Pole`width`	Typinteger \| null	VýznamŠířka videa v pixelech; null, není-li dostupná.
Pole`height`	Typinteger \| null	VýznamVýška videa v pixelech; null, není-li dostupná.
Pole`video_codec`	Typstring \| null	VýznamIdentifikátor video kodeku; null, není-li zaznamenán.
Pole`has_audio`	Typboolean \| null	VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno.
Pole`audio_codec`	Typstring \| null	VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán.

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď404 · `not_found_error`	PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno.	Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.
Odpověď401 · `authentication_error`	PodmínkaKlíč API neodpovídá ověřenému účtu.	Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu.
Odpověď400 · `invalid_request_error`	PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný.	Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.
Odpověď422 · `price_unavailable`	PodmínkaVybranou konfiguraci videa nelze ocenit.	Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.
Odpověď422 · `invalid_request_error`	PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné.	Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.
Odpověď402 · `billing_error`	PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci.	Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.
Odpověď503 · `server_error`	PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.	Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.
Odpověď503 · `result_pending_check`	PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.	Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.
Odpověď503 · `owned_result_unavailable`	PodmínkaStávající video je dočasně nedostupné ke stažení.	Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.
Odpověď409 · `video_not_ready`	PodmínkaObsah videa nebyl zveřejněn.	Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.

Aliasy

Aliasy modelu

Ailoot Ultra x-ai/grok-imagine-video-1.5

Aliasy cest metod

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

Související ID modelů

x-ai/grok-imagine-video-1.5

FAQ · SpaceXAI: Grok Imagine Video 1.5

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos · x-ai/grok-imagine-video-1.5: text, image → video
Jaká pole požadavek používá?: POST /v1/videos · x-ai/grok-imagine-video-1.5: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user
Jaké limity platí?: POST /v1/videos · x-ai/grok-imagine-video-1.5: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 1; frame_images.min_items: 1

SpaceXAI: Grok Imagine Video 1.5