Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Končna točka /v1/videos/generations: Vaš prvi video

Lekcija 1 od 12 Posodobljeno 3. november 2026 Srednje napredni
Na tej strani
  1. Ustvarjanje videa iz besedila
  2. Struktura zahteve
  3. Prvi klic od začetka do konca
  4. Zvok je privzet
  5. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi dokumentacije xAI za videe: na voljo so trije video modeli (grok-imagine-video-1.5, njegova različica -lite in grok-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, parameter size, 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.

1–15 s
Trajanje na video
1080p
Največja ločljivost
od 0,02 $
Na generirano sekundo
9
Razpoložljiva razmerja

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čica grok-imagine-video-1.5-lite, ki jo xAI priporoča za preproste videe, ali grok-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), 720p ali 1080p – slednjo model grok-imagine-video-1.5 pri pretvorbi besedilo-v-video in slika-v-video izriše naravno, pri različici -lite jo dobimo z vzorčenjem iz 720p, pri modelu grok-imagine-video pa 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 modeli grok-imagine-video-1.5, njegovo različico -lite ali grok-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": false vrne tihi video