Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Koncový bod /v1/videos/generations: Vaše prvé video

Lekcia 1 z 12 Aktualizované 3. novembra 2026 Mierne pokročilý
Na tejto strane
  1. Generovanie videa z textu
  2. Štruktúra požiadavky
  3. Prvé volanie od začiatku do konca
  4. Zvuk štandardne
  5. Kľúčové poznatky

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 -lite verzia a grok-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 parameter size prezentovaný 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íš.

1-15s
Dĺžka videa
1080p
Maximálne rozlíšenie
od 0,02 $
Za vygenerovanú sekundu
9
Dostupné pomery strán

Š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á verzia grok-imagine-video-1.5-lite, ktorú xAI odporúča pre jednoduché videá, alebo grok-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é), 720p alebo 1080p – posledné menované sa natívne vykresľuje modelom grok-imagine-video-1.5 pri texte-na-video aj obraze-na-video, získava sa vzorkovaním z 720p pri -lite verzii a chýba pri grok-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 modelmi grok-imagine-video-1.5, jeho -lite verziou alebo grok-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": false vytvorí tiché video