Koncový bod /v1/videos/generations: Vaše prvé video
Na tejto strane
Aktualizované 3. novembra 2026 na základe dokumentácie xAI k videu: k dispozícii sú tri video modely (
grok-imagine-video-1.5, jeho-liteverzia agrok-imagine-video), rozlíšenie dosahuje až 1080p pri modeloch 1.5, videá majú štandardne zvukovú stopu (generate_audio), limity rýchlosti sa počítajú v požiadavkách za sekundu a parametersizeprezentovaný v starej verzii sa v referencii API neobjavuje. Zdroje: Generovanie videa · Cenník.
Generovanie videa z textu
API xAI poskytuje vyhradený koncový bod pre video, POST /v1/videos/generations, ktorý transformuje písaný opis na animovanú sekvenciu pomocou jedného z troch modelov Grok Imagine Video. Predstav si to ako štúdio na požiadanie: opíšeš scénu, model ju uvedie do pohybu a ty získaš súbor MP4 pripravený na úpravy. Propagačné klipy, vizualizácie konceptov, ilustračné animácie – všetky tieto prípady použitia prechádzajú tým istým koncovým bodom, preto ho najprv rozoberieme.
Príklad vyššie ti dá predstavu o očakávanom výstupe. Pred napísaním tvojej prvej požiadavky maj na pamäti štyri hranice, ktoré rámujú všetko, čo s týmito modelmi vytvoríš.
Štruktúra požiadavky
Telo požiadavky je objekt JSON reassuringnej jednoduchosti. Deklaruješ model, napíšeš svoj prompt a výsledok orámuješ tromi parametrami formátovania.
{
"model": "grok-imagine-video",
"prompt": "A dolphin jumping in a sunset",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Tu je presný význam každého poľa:
- model:
grok-imagine-video-1.5, najnovší, jeho ekonomická verziagrok-imagine-video-1.5-lite, ktorú xAI odporúča pre jednoduché videá, alebogrok-imagine-video, predchádzajúca generácia, stále používaná v príkladoch tohto kurzu - prompt: tvoj textový opis požadovanej scény
- duration: dĺžka v sekundách, medzi 1 a 15 (predvolené 8)
- aspect_ratio: pomer strán obrázka (predvolené 16:9, ďalej 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2)
- resolution:
480p(predvolené),720palebo1080p– posledné menované sa natívne vykresľuje modelomgrok-imagine-video-1.5pri texte-na-video aj obraze-na-video, získava sa vzorkovaním z 720p pri-liteverzii a chýba prigrok-imagine-video, ktorý končí na 720p
Dva body si zaslúžia okamžité zdôraznenie. Model grok-imagine-video stojí 0,050 $ za sekundu vygenerovaného videa (0,08 $ za grok-imagine-video-1.5, 0,02 $ za jeho -lite verziu, platné k 3. novembru 2026): päťsekundová sekvencia ťa teda stojí 0,25 $ s prvým menovaným, bez ohľadu na to, koľko pokusov ťa k nej doviedlo. A limit rýchlosti sa počíta v požiadavkách za sekundu v závislosti od úrovne vášho tímu: 10 pri vstupnej úrovni pre video modely, čo je pohodlná rezerva pre bežné použitie, ktorá sa stáva obmedzením pri spúšťaní masívnych dávok.
Najdôležitejšie je, že generovanie je asynchrónne. Tvoj volací príkaz POST nevráti video: vráti request_id a je len na tebe, aby si zisťoval stav, kým nebude súbor pripravený. Tento mechanizmus zisťovania stavu je predmetom celej lekcie neskôr v kurze; zatiaľ si len zapamätaj, že okamžitá odpoveď je potvrdením, nie výsledkom.
Prvé volanie od začiatku do konca
Prejdime k praxi s curlom. Nasledujúca požiadavka objednáva päťsekundovú sekvenciu v rozlíšení 720p a formáte na šírku.
curl -X POST "https://api.x.ai/v1/videos/generations" \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A cat playing with a ball of yarn in a bright living room",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'
Odpoveď sa zmestí na jeden riadok:
{
"request_id": "vid_abc123def456"
}
Tento identifikátor si starostlivo uschovaj. Je to tvoja jediná cesta, ako získať video po dokončení generovania, a aplikácia, ktorá ho stratí, zaplatila za generovanie, ktoré nikdy nezíska. V reálnej službe ho zaznamenáš do logu ešte predtým, než začneš zisťovať stav.
Zvuk štandardne
Vygenerované video obsahuje štandardne zvukovú stopu – pričom pri grok-imagine-video-1.5 a jeho -lite verzii je reč synchronizovaná s pohybom pier. Pre tiché video, určené napríklad ako pozadie webu alebo na úpravy, kde pridáš vlastnú hudbu, pridaj do požiadavky "generate_audio": false.
Na orámovanie výstupu však API pozná len pomer (aspect_ratio) a definíciu (resolution): referencia API neposkytuje žiadny parameter pre veľkosť v pixeloch. Pri obraze-na-video výstupný pomer vždy nasleduje pomer zdrojového obrázka.
Kľúčové poznatky
- Koncový bod je
POST /v1/videos/generations, s modelmigrok-imagine-video-1.5, jeho-liteverziou alebogrok-imagine-video - Dĺžka sa pohybuje od 1 do 15 sekúnd (predvolené 8), rozlíšenie od 480p do 1080p (max 720p pri
grok-imagine-video) - Cena sa počíta za vygenerovanú sekundu: 0,020 $ (
-lite), 0,050 $ (grok-imagine-video) alebo 0,080 $ (grok-imagine-video-1.5) - Generovanie je asynchrónne: dostaneš
request_id, ktorý následne monitoruješ - K dispozícii je deväť pomerov strán prispôsobiteľných všetkým formátom
- Zvuková stopa sa generuje štandardne;
"generate_audio": falsevytvorí tiché video