Končna točka /v1/videos/generations: Vaš prvi video
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi dokumentacije xAI za videe: na voljo so trije video modeli (
grok-imagine-video-1.5, njegova različica-liteingrok-imagine-video), ločljivost pri modelih 1.5 doseže do 1080p, videoposnetki imajo privzeto zvočni zapis (generate_audio), omejitve hitrosti se štejejo v zahtevah na sekundo, parametersize, predstavljen v stari različici, pa se v referenci API ne pojavlja. Viri: Generiranje videa · Cenik.
Ustvarjanje videa iz besedila
API xAI ponuja namensko končno točko za videe, POST /v1/videos/generations, ki pretvori pisni opis v animirano zaporedje z uporabo enega od treh modelov Grok Imagine Video. Razmišljaj o tem kot o studiu po meri: opišeš prizor, model ga oživi in ti prejmeš datoteko MP4, pripravljeno za urejanje. Promocijski posnetki, vizualizacije konceptov, ilustrativne animacije – vsi ti primeri uporabe potekajo skozi isto končno točko, zato jo bomo najprej razčlenili.
Zgornji primer ti daje predstavo o pričakovanem izidu. Preden napišeš svojo prvo zahtevo, imej v mislih štiri meje, ki določajo vse, kar ustvariš s temi modeli.
Struktura zahteve
Telo zahteve je objekt JSON presenetljive preprostosti. Določiš model, napišeš poziv in rezultat oblikuješ s tremi parametri za oblikovanje.
{
"model": "grok-imagine-video",
"prompt": "Delfin skače ob sončnem zahodu",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Tukaj je točen pomen vsakega polja:
- model:
grok-imagine-video-1.5(najnovejši), njegova varčna različicagrok-imagine-video-1.5-lite, ki jo xAI priporoča za preproste videe, aligrok-imagine-video(prejšnja generacija), ki se še vedno uporablja v primerih tega tečaja - prompt: tvoj besedni opis želenega prizora
- duration: trajanje v sekundah, med 1 in 15 (privzeto 8)
- aspect_ratio: razmerje slike (privzeto 16:9; na voljo so tudi 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2)
- resolution:
480p(privzeto),720pali1080p– slednjo modelgrok-imagine-video-1.5pri pretvorbi besedilo-v-video in slika-v-video izriše naravno, pri različici-litejo dobimo z vzorčenjem iz 720p, pri modelugrok-imagine-videopa tega parametra ni, saj se ustavi pri 720p
Dve točki si zaslužita takojšnjo poudaritev. Model grok-imagine-video stane 0,050 $ na sekundo generiranega videa (model grok-imagine-video-1.5 0,08 $, njegova različica -lite pa 0,02 $; stanje na dan 3. novembra 2026): petsekundno zaporedje te tako s prvim modelom stane 0,25 $, ne glede na to, koliko poskusov si potreboval do končnega rezultata. Omejitev hitrosti se šteje v zahtevah na sekundo in je odvisna od ravni tvoje ekipe: pri osnovni ravni za video modele je to 10 zahtev, kar je za običajno uporabo udobna rezerva, postane pa omejitev, ko sprožiš množične serije.
Najpomembneje: generiranje je asinhrono. Tvoj klic POST ne vrne videa: vrne request_id, nato pa je na tebi, da redno preverjaš stanje, dokler datoteka ni pripravljena. Ta mehanizem preverjanja je tema celotne lekcije kasneje v tečaju; za zdaj si zapomni le, da je takojšnji odgovor potrdilo prejema, ne pa rezultat.
Prvi klic od začetka do konca
Preidimo k praksi s curlom. Naslednja zahteva naroči petsekundno zaporedje v ločljivosti 720p in ležečem formatu.
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": "Mačka se igra s klopčičem preje v svetli dnevni sobi",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'
Odgovor se prilega v eno vrstico:
{
"request_id": "vid_abc123def456"
}
Ta identifikator skrbno shrani. Je tvoja edina pot do videa, ko je generiranje končano, in aplikacija, ki ga izgubi, je plačala generiranje, ki ga nikoli ne bo prejela. V realni storitvi ga zabeležiš v dnevnik, še preden začneš s preverjanjem stanja.
Zvok je privzet
Generirani video privzeto vključuje zvočni zapis – pri modelih grok-imagine-video-1.5 in njegovi različici -lite je govor usklajen z gibom ustnic. Za tihi video, namenjen na primer ozadju spletnega mesta ali urejanju, kjer boš dodal svojo glasbo, v zahtevo dodaj "generate_audio": false.
Za okvirjenje izhoda API pozna le razmerje (aspect_ratio) in ločljivost (resolution): parameter za velikost v pikslih v referenci API ni na voljo. Pri pretvorbi slika-v-video izhodno razmerje vedno sledi razmerju izvorne slike.
Ključne ugotovitve
- Končna točka je
POST /v1/videos/generations, z modeligrok-imagine-video-1.5, njegovo različico-litealigrok-imagine-video - Trajanje je od 1 do 15 sekund (privzeto 8), ločljivost od 480p do 1080p (največ 720p pri
grok-imagine-video) - Cena se obračunava na generirano sekundo: 0,020 $ (
-lite), 0,050 $ (grok-imagine-video) ali 0,080 $ (grok-imagine-video-1.5) - Generiranje je asinhrono: prejmeš
request_id, ki ga nato uporabiš za preverjanje stanja - Na voljo je devet razmerij stranic za prilagoditev vsem formatom
- Zvočni zapis se generira privzeto;
"generate_audio": falsevrne tihi video