Razširitev videoposnetka z /v1/videos/extensions
Na tej strani
Lekcija posodobljena 2. novembra 2026 na podlagi referenčne dokumentacije xAI Video API: razširitev prejme videoposnetek v predmetu
video({"url": ...}), popolnoma kot pri urejanju – prejšnje besedilo je trdilo nasprotno – rezultat se prebere izvideo.url, vir pa je omejen na 15 sekund. Viri: Video Extension · Video Reference.
Razširjanje obstoječega videoposnetka
Kjer urejanje preoblikuje zaporedje brez spremembe njegove dolžine, razširjanje stori točno nasprotno: podaljša videoposnetek z ustvarjanjem nadaljevanja, ki je skladno s tem, kar je bilo pred tem. To rešuje najpogostejši problem pri ustvarjanju videoposnetkov – uspešen posnetek, ki je prekratek, ali prizor, ki si zasluži razvoj dlje od začetnega trajanja. Namesto da bi znova ustvarili vse in upali na ponovitev istega videza, začnete s tem, kar že obstaja, in nadaljujete.
Končna točka POST /v1/videos/extensions
Zahteva je podobna zahtevi za ustvarjanje, le da ji je dodan začetni videoposnetek.
{
"model": "grok-imagine-video",
"prompt": "Continue the scene with a zoom out revealing the full landscape",
"video": {"url": "https://exemple.com/video-courte.mp4"},
"duration": 5
}
Polje model ostane grok-imagine-video, prompt opisuje, kaj naj se zgodi v nadaljevanju, predmet video določa videoposnetek za razširitev (url ali file_id naložene datoteke, za vir od 2 do 15 sekund), duration pa nastavi dolžino razširitve med 2 in 10 sekundami – privzeto je 6 sekund. Za razliko od urejanja tu ponovno pridobite nadzor nad trajanjem. Vrnjeni videoposnetek vsebuje izvirnik, ki mu sledi razširitev: 10-sekundni vir, razširjen za 5 sekund, da 15-sekundni videoposnetek.
Naslednja tabela povzema razlike med obema končnima točkama, saj prihaja do zmede.
| Vidik | Urejanje (/edits) | Razširjanje (/extensions) |
|---|---|---|
| Cilj | Sprememba vsebine | Dodajanje trajanja |
| Parameter videa | Predmet video (url ali file_id) | Predmet video (url ali file_id) |
| Trajanje vira | Največ 8,7 s | 2 do 15 s |
| Izhodno trajanje | Enako kot vir (največ 720p) | Vir + 2 do 10 s |
| Izvirna vsebina | Spremeni | Ohrani |
Obe končni točki REST API prejmeta videoposnetek na enak način, v predmetu video z lastnostjo url. Python SDK pa ga sprejme kot parameter video_url: tega imena parametra ne kopirajte v telo JSON, saj ga API ne bo prepoznal. Tisto, kar resnično loči obe končni točki, je trajanje.
Trije načini nadaljevanja prizora
Najpreprostejši primer je, da pustite dogajanje teči dalje. Poziv (prompt) prevzame trenutno dejanje in ga razširi brez prekinitve.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Lahko tudi uvedete spremembo, kar pomeni vnos novega elementa ali spremembo smeri pogleda. S tem zaporedju zagotovite narativni napredek.
{
"model": "grok-imagine-video",
"prompt": "The camera pivots right revealing a lighthouse in the distance, the lighthouse beam starts to rotate",
"video": {"url": "https://exemple.com/plage.mp4"},
"duration": 8
}
Tretji primer uporabe je zaključek: kratka razširitev, ki čisto zaključi zaporedje, pogosto s postopnim izginotjem (fade).
{
"model": "grok-imagine-video",
"prompt": "The scene ends with a gradual fade to black, the last glimmers of sunlight disappear on the horizon",
"video": {"url": "https://exemple.com/coucher-soleil.mp4"},
"duration": 4
}
Veriženje razširitev za gradnjo zaporedja
Nič vam ne preprečuje večkratnega zaporednega razširjanja videoposnetka. Vsaka razširitev ustvari nov videoposnetek, katerega URL lahko služi kot vir za naslednjo razširitev, kar vam omogoča gradnjo dolgega zaporedja prek zaporednih segmentov, od katerih vsakega poganja svoj poziv. Spodnja skripta veriži tri razširitve z vnovičnim vnosom pridobljenega URL-ja na vsakem koraku.
import httpx
import time
api_key = "your_key"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
def attendre_video(request_id):
"""Poll status until completion."""
while True:
resp = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers=headers
).json()
if resp["status"] == "done":
return resp["video"]["url"]
if resp["status"] == "failed":
raise RuntimeError(f"Generation failed: {resp.get('error')}")
time.sleep(5)
# Base video
video_url = "https://exemple.com/video-initiale.mp4"
# Chain 3 extensions
prompts = [
"The character crosses the bridge, profile view",
"He stops in the middle and looks at the river below",
"He resumes walking toward the other bank, the camera follows"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/extensions",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"video": {"url": video_url},
"duration": 5
}
).json()
video_url = attendre_video(resp["request_id"])
print(f"Extension complete: {video_url}")
Ta eleganca ima svojo ceno, dobesedno in v prenesenem pomenu. Vsaka razširitev se zaračuna posebej. Vir ne sme presegati 15 sekund, kar omejuje verigo: če začnete s 5 sekundami, zaporedje po treh 5-sekundnih razširitvah doseže 20 sekund, četrta pa bo zavrnjena. Vizualna koherenca se skozi povezave poslabša, saj vsak korak temelji na že interpretiranem izhodu: po več kot treh ali štirih veriženih razširitvah postanejo vidna odstopanja v barvah in morfologiji. In kot povsod v tem API-ju, so URL-ji začasni – prenesite vsako vmesno različico, sicer vas bo napaka na koncu verige prisilila, da začnete znova od začetka.
Duet ustvarjanja in razširjanja
Najpogostejši vzorec v proizvodnji združuje obe končni točki. Najprej ustvarite kratko 3-sekundno osnovo z zelo natančnim pozivom prek POST /v1/videos/generations, kar vam omogoča iteracijo začetne estetike ob nižjih stroških. Nato dodate 5 sekund razvoja prek POST /v1/videos/extensions in nato 4 sekunde zaključka z drugim klicem iste končne točke. Rezultat je 12-sekundni videoposnetek, zgrajen segment za segmentom, kjer je bil vsak del potrjen, preden se je začel naslednji – nadzor, ki ga nobeno enojno 12-sekundno ustvarjanje ne bi omogočilo.
Ključne ugotovitve
- Razširitev podaljša videoposnetek od 2 do 15 sekund za segment od 2 do 10 sekund (privzeto 6) in vrne celoten videoposnetek
- Izvirni videoposnetek gre v predmet
video(urlalifile_id), kot pri urejanju; Python SDK ga sprejme kotvideo_url - Veriženje omogoča ustvarjanje dolgih zaporedij korak za korakom
- Koherenca se poslabša po več kot 3–4 zaporednih razširitvah
- Združite začetno ustvarjanje in razširitve za natančen nadzor vsebine