SpaceXAI: Grok Imagine Video
Grok Imagine Video generuje krátké klipy z textu, počátečního obrázku nebo až sedmi vizuálních referencí. Jeho klasická verze také upravuje existující MP4 a přidává 2–10 sekund pokračování. Generování dosahuje 720p se zvukem; úpravy a prodlužování zachovávají rámování zdroje v rámci vlastních limitů.
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 je klasická verze rodiny videomodelů Grok Imagine. Aktuální dokumentace výrobce pokrývá generování nového klipu z promptu, animaci počátečního obrázku, používání vizuálních referencí i změny či pokračování existujícího videa. Tyto postupy vytvářejí různé výstupy: novou scénu, upravenou verzi dodaného záznamu nebo jedno video obsahující původní záznam následovaný novým obsahem. Postup zvolte podle již dostupného materiálu a části záběru, kterou je třeba změnit.
U nového záběru z textu popište objekt, prostředí, viditelnou akci, kameru a zvuk. Standardní generování podporuje klipy 1–15 sekund, s výstupem 480p nebo 720p a generovaným zvukem. Dokumentovány jsou čtvercové, široké, portrétní i širší poměry včetně 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 a 5:2. Původní zadání může žádat papírový lampion jemně se pohybující nad klidným nádvořím při bočním pojezdu kamery. Užitečná kontrola ověřuje, zda pohyb, rámování a okolní zvuk podporují tento jediný záběr.
U převodu obrázku na video je dodaný statický obrázek prvním snímkem. Připravte jej se zamýšleným ořezem, objektem a viditelnými detaily a potom popište následující akci. Výstup sleduje poměr stran obrázku. Počáteční obrázek dává přesnou úvodní kompozici, zatímco převod referencí na video používá obrázky pro vedení osob, produktů nebo prostředí v nově sestavené scéně. Oddělení těchto dvou rolí pomáhá zabránit nezamýšlenému úvodu, má-li být známý předmět umístěn do jiného prostředí.
Klasický model přijímá až sedm referenčních obrázků na referenčně vedený požadavek. Tento režim je omezen na deset sekund a 720p. Každé referenci dejte jasnou roli a určete ji pozicí v seznamu počínaje <IMAGE_0>. U produktové scénky může jedna reference identifikovat předmět a druhá požadované místo. Zadání soustřeďte na umístění předmětu a hlavní akci záběru. Klasický referenční režim má vlastní konfiguraci; plná verze 1.5 dodává další ovládání vybraného hlasu a ukotvených snímků.
Úprava videa přijímá existující klip a prompt popisující změnu. Výrobce přijímá zdroje MP4 s podporovanými kodeky jako H.264, H.265 nebo AV1, do délky 8.7 sekundy. Upravený výsledek zachovává délku a poměr stran zdroje a sleduje jeho rozlišení do stropu 720p. Vlastní ovládání délky, poměru stran a rozlišení se na tento editační postup nevztahuje. Připravte zdroj, který již má kompozici a časování potřebné pro konečné použití, aby se prompt mohl soustředit na zamýšlenou vizuální změnu.
Původní zadání úpravy může změnit barvu šály při zachování tváře osoby, pohybu, pozadí a kamery. Tyto zachovávané prvky uveďte výslovně společně se změnou. Výrobce popisuje zachování zbytku zdroje co nejvěrněji; jde o užitečný cíl kontroly, nikoli záruku totožnosti každého pixelu. Výsledek porovnávejte v celém klipu, zvláště když se předmět pohybuje, kříží s jiným nebo se částečně skrývá. Konečným výstupem je upravený klip, nikoli pouze statický obrázek nové barvy.
Prodlužování videa pokračuje od posledního snímku existujícího MP4. Dokumentovaná délka zdroje je 2–15 sekund; přidaná část má 2–10 sekund s výchozími šesti sekundami. Délka prodloužení se týká pouze nové části. Desetisekundový zdroj následovaný pěti sekundami pokračování vytváří patnáctisekundové video obsahující obě části. Výsledek zachovává poměr stran a rozlišení zdroje do stropu 720p. Připravte poslední okamžik zdroje a popište následující děj, například otočení objektu k přibližujícímu se předmětu, zatímco kamera pokračuje dosavadním pohybem.
Prodloužení kontrolujte kolem hranice mezi zdrojem a novým obsahem. Ověřte identitu objektu, směr pohybu, tempo kamery, světlo a zvuk, aby pokračování odpovídalo předcházející akci. Končí-li klip v obrazově nevhodném bodě, zahrňte tuto hranici výslovně do plánu dalšího záběru. Sestavení delší scény je rozhodnutím střihu: limity délky generování, referencí, úprav a prodlužování modelu jsou samostatné a celkový výsledek prodloužení může být delší než standardní nově generovaný klip.
Video postup výrobce je asynchronní. Identifikátor požadavku sleduje úkol, dokud dokončený výsledek nedodá umístění videa a délku; výstupní umístění jsou dočasná. Při přípravě produkčního střihu uchovejte přehratelný výsledek a jeho zdrojové materiály. Plný Grok Imagine Video 1.5 nabízí nativní generování 1080p a bohatší ukotvení obrazu, hlasu a snímků, zatímco Lite slouží pro jednoduchou práci s promptem či počátečním obrázkem. Klasická verze zůstává užitečná, když výchozím materiálem je již video vyžadující řízenou změnu nebo pokračování.
Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video
x-ai/grok-imagine-videoÚvod
Grok Imagine Video generuje krátké klipy z textu, počátečního obrázku nebo až sedmi vizuálních referencí. Jeho klasická verze také upravuje existující MP4 a přidává 2–10 sekund pokračování. Generování dosahuje 720p se zvukem; úpravy a prodlužování zachovávají rámování zdroje v rámci vlastních limitů.
- 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í |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity x-ai/grok-imagine-video | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Poleduration | Typinteger | 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í— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 480p, 720p | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Výchozí— |
Polegenerate_audio | Typboolean | PožadavekVolitelné | Hodnoty a limity false | Výchozí— |
Poleframe_images | Typarray | 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í— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity 854x480, 1280x720, 480x854, 720x1280, 480x480, 720x720, 640x480, 960x720, 480x640, 720x960, 720x480, 1080x720, 480x720, 720x1080 Vzor: ^[1-9][0-9]*x[1-9][0-9]*$ | Výchozí— |
Polecallback_url | Typstring | PožadavekVolitelné | Hodnoty a limity Vzor: ^https:// | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletrace | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | 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í; přidejte poměr stran nebo použijte uvedenou velikost.
model: Typ: string · x-ai/grok-imagine-video
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. V jednom požadavku používejte buď obrázky snímků, nebo obrazové reference; obojí nekombinujte. Vyberte podporované rozlišení; přidejte poměr stran nebo použijte uvedenou velikost.
Přesné klíče: type, image_url, frame_type
model: Typ: string · x-ai/grok-imagine-video
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Reference to video · Textové zadání a podporované obrazové reference. · Povinné: model, prompt, duration, input_references
input_references je pole objektů. Nastavte type na image_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Nekombinujte obrazové reference s obrázky snímků. Vyberte podporované rozlišení; přidejte poměr stran nebo použijte uvedenou velikost.
model: Typ: string · x-ai/grok-imagine-video
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 |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontraktfalse |
Parametroptional_controls | Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, size, 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.004 za obrázek |
| 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.1 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.14 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.1 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.004 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.1 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.14 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
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","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
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
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 |
|---|---|---|
Poleindex | Typinteger | VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný. |
Polesize_bytes | Typinteger | null | VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná. |
Poleduration_ms | Typinteger | null | VýznamNaměřená délka videa v milisekundách; null, není-li dostupná. |
Polewidth | Typinteger | null | VýznamŠířka videa v pixelech; null, není-li dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixelech; null, není-li dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, není-li zaznamenán. |
Polehas_audio | Typboolean | null | VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno. |
Poleaudio_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
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · SpaceXAI: Grok Imagine Video
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·x-ai/grok-imagine-video:text,image→video- Jaká pole požadavek používá?
POST /v1/videos·x-ai/grok-imagine-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Jaké limity platí?
POST /v1/videos·x-ai/grok-imagine-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1