SpaceXAI: Grok Imagine Video 1.5 Lite
Grok Imagine Video 1.5 Lite generuje krátké klipy se zvukem z písemné scény nebo počátečního obrázku. Podporuje výstup 1–15 sekund, široké i portrétní rámování a řeč se synchronizací rtů. Vyberte přímo 480p či 720p nebo výstup 1080p zvětšený ze 720p; pokročilé reference a ovládání snímků patří plné verzi 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 Lite je zjednodušená generovací verze rodiny videomodelů Grok Imagine. Výrobce ji doporučuje pro přímočarou práci s převodem textu nebo obrázku na video. Písemná scéna se může stát krátkým klipem nebo dodaný statický obrázek může sloužit jako úvodní snímek animovaného záběru. Výstup zahrnuje generovaný zvuk a tato verze podporuje řeč se synchronizací rtů. Užitečné výstupy zahrnují krátký pohyb produktu, atmosférický úvodní záběr nebo jednoduchý mluvený okamžik postavy.
U převodu textu na video popište, co je vidět, co se během záběru děje a jak má kamera dění sledovat. Zahrňte osvětlení, tempo a relevantní zvuk. Výrobce vysvětluje, že Lite nejprve vykreslí obrázek z promptu a potom jej animuje; tento mezilehlý statický obrázek se nevrací jako samostatný podklad. Při praktické přípravě dejte krátkému klipu jednu jasnou událost a dostatek prostoru pro její průběh. Široké venkovní prostředí, blízký produktový detail a mluvící portrét vyžadují odlišnou kompozici i vedení pohybu.
Původní zadání může například požadovat pomalé přiblížení ke keramickému šálku na klidném snídaňovém stole při stoupání páry, s jemným ranním světlem a tlumenými zvuky místnosti. Důležitým výsledkem ke kontrole je rozpoznatelnost šálku, přirozený pohyb páry a sledování zamýšleného směru kamerou. Při posuzování záběru zachovejte pohyb tohoto příkladu jednoduchý. Pokud postava mluví, zahrňte zamýšlenou repliku a stručný popis přednesu a potom ve výsledku ověřte slova i viditelný pohyb úst.
U převodu obrázku na video obrázek stanovuje první snímek a prompt popisuje, co se děje dál. Vyberte počáteční obrázek s již přítomným zamýšleným objektem, rámováním a vizuálními detaily. Dodejte pokyny pohybu odpovídající existující kompozici, například malé otočení hlavy, jemný pohyb kamery nebo vítr působící na látku. Výstup sleduje poměr stran obrázku; samostatné nastavení poměru stran se v tomto režimu ignoruje. Pokud konečný klip potřebuje portrétní rámování, připravte portrétní ořez předem.
Dokumentovaná délka výstupu je 1–15 sekund s výchozími osmi sekundami. Převod textu na video nabízí čtvercové, široké, portrétní i širší kompozice včetně 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 a 5:2. Před výběrem rámování rozhodněte, jak bude záběr použit. Portrétní klip pro sociální sítě může potřebovat prostor pro pozdější titulky, zatímco široká vložka může potřebovat místo kolem objektu pro pohodlný střih. Požadovanou akci přizpůsobte délce klipu, místo vtěsnání dlouhé sekvence do jediného krátkého záběru.
Lite nabízí výstup 480p a 720p i možnost 1080p vytvořenou zvětšením 720p. Tento rozdíl je důležitý při plánování materiálu citlivého na detaily: větší výstupní snímek neznamená, že tato verze vykresluje scénu nativně v 1080p. Malé nápisy, okraje produktu a tváře ověřte při zamýšlené velikosti zobrazení. Generovaná videa ve výchozím nastavení obsahují zvuk a konfigurace generování výrobce umožňuje také tichý výsledek. Pokud bude klip použit s generovanou stopou, určete zvukový záměr stejně pečlivě jako viditelnou akci.
Generování je v dokumentovaném rozhraní výrobce asynchronní. Identifikátor požadavku sleduje práci během čekání; dokončená odpověď poskytuje umístění videa a délku. Dokončený příklad v příručce odkazuje na klip MP4 a vysvětluje, že výstupní umístění jsou dočasná. Při přípravě střihu uchovejte hotový výstup společně s promptem, zdrojovým obrázkem a vybranými nastaveními. Odeslaný úkol stále představuje krok zpracování; užitečným produkčním výsledkem je přehratelný klip s požadovaným obrazem a zvukem.
Volba verze vychází z ovládání potřebného pro záběr. Plný Grok Imagine Video 1.5 přidává reference více obrázků, vybrané hlasové reference, přesný první nebo poslední snímek i mezilehlé ukotvené snímky a vykresluje text či obrázek na video v nativním 1080p. Lite se soustředí na prompt nebo jeden počáteční obrázek. Klasická verze Grok Imagine Video poskytuje postupy úprav a prodlužování videa. Tyto rozdíly pomáhají zvolit model podle již dostupných vstupních materiálů, místo považování všech členů rodiny za stejný generátor.
Hotový záběr zkontrolujte z hlediska návaznosti objektu, věrohodného pohybu, rámování a požadovaného zvuku. U dialogu kontrolujte slova i jejich synchronizaci s postavou. Při přípravě několika klipů pro sekvenci zachovejte příslušný popis objektu nebo počáteční vizuál v každém zadání a posuďte spoje ve střihu. Dobře určený krátký záběr se snáze diagnostikuje: kontrola může identifikovat, zda se další změna týká zdrojového obrázku, akce, kamery nebo mluvené repliky.
Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video-1.5-lite
x-ai/grok-imagine-video-1.5-lite
x-ai/grok-imagine-video-1.5-liteÚvod
Grok Imagine Video 1.5 Lite generuje krátké klipy se zvukem z písemné scény nebo počátečního obrázku. Podporuje výstup 1–15 sekund, široké i portrétní rámování a řeč se synchronizací rtů. Vyberte přímo 480p či 720p nebo výstup 1080p zvětšený ze 720p; pokročilé reference a ovládání snímků patří plné verzi 1.5.
- 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-1.5-lite | 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, 1080p | 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í— |
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í a případně poměr stran.
model: Typ: string · x-ai/grok-imagine-video-1.5-lite
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-lite
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, 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.28 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.04 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.06 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.04 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.04 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.06 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.28 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-1.5-lite","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-1.5-lite
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · SpaceXAI: Grok Imagine Video 1.5 Lite
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·x-ai/grok-imagine-video-1.5-lite:text,image→video- Jaká pole požadavek používá?
POST /v1/videos·x-ai/grok-imagine-video-1.5-lite: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-lite:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1