Proširenje videa s /v1/videos/extensions
Na ovoj stranici
Lekcija ažurirana 2. studenoga 2026. na temelju referencije xAI Video API-ja: proširenje prima video u objektu
video({"url": ...}), točno kao i uređivanje—prethodni tekst je tvrdio suprotno—rezultat se čita izvideo.url, a izvor je ograničen na 15 sekundi. Izvori: Video Extension · Video Reference.
Proširivanje postojećeg videa
Dok uređivanje transformira sekvencu bez promjene njezine duljine, proširenje radi točno suprotno: produljuje video generiranjem nastavka dosljednog onome što je prethodilo. To rješava najčešći problem u generiranju videa—uspješan isječak koji je prekratak ili scenu koja zaslužuje razvoj izvan početnog trajanja. Umjesto ponovnog generiranja svega u nadi da ćete rekreirati isti izgled, krećete od onoga što postoji i nastavljate dalje.
POST /v1/videos/extensions endpoint
Zahtjev nalikuje zahtjevu za generiranje, uz dodatak početnog videa.
{
"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 ostaje grok-imagine-video, prompt opisuje što se treba dogoditi u nastavku, objekt video specificira video koji se proširuje (url ili file_id učitane datoteke, za izvor od 2 do 15 sekundi), a duration postavlja duljinu proširenja između 2 i 10 sekundi—zadana vrijednost je 6 sekundi. Za razliku od uređivanja, ovdje ponovno dobivaš kontrolu nad trajanjem. Vraćeni video sadrži original praćen proširenjem: izvor od 10 sekundi proširen za 5 sekundi daje video od 15 sekundi.
Sljedeća tablica sažima što razdvaja ova dva endpointa, budući da je zabuna česta.
| Aspekt | Uređivanje (/edits) | Proširenje (/extensions) |
|---|---|---|
| Cilj | Modificiranje sadržaja | Dodavanje trajanja |
| Parametar videa | Objekt video (url ili file_id) | Objekt video (url ili file_id) |
| Trajanje izvora | Maks. 8,7 s | 2 do 15 s |
| Trajanje izlaza | Isto kao izvor (Maks. 720p) | Izvor + 2 do 10 s |
| Originalni sadržaj | Modificira | Čuva |
Oba REST API endpointa primaju video na isti način, u objektu video s svojstvom url. Python SDK, međutim, prima ga kao parametar video_url: nemoj kopirati ovo ime parametra u JSON tijelo, API ga neće prepoznati. Ono što doista razlikuje ova dva endpointa jest trajanje.
Tri načina za nastavak scene
Najjednostavniji slučaj sastoji se od puštanja da se ono što se već događa nastavi. Prompt preuzima trenutnu radnju i proširuje je bez prekida.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Možeš također uvesti promjenu, što znači donošenje novog elementa ili modificiranje smjera pogleda. To sekvenci daje narativni progres.
{
"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
}
Treći slučaj upotrebe je zaključak: kratko proširenje koje uredno zatvara sekvencu, često s postupnim nestajanjem (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
}
Lančano povezivanje proširenja za izgradnju sekvence
Ništa te ne sprječava da video proširiš više puta zaredom. Svako proširenje proizvodi novi video čiji se URL može koristiti kao izvor za sljedeće proširenje, omogućujući ti izgradnju duge sekvence putem uzastopnih segmenata, od kojih svaki pokreće vlastiti prompt. Skripta u nastavku lančano povezuje tri proširenja ponovnim ubacivanjem dobivenog URL-a u svakom 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}")
Ova elegancija ima svoju cijenu, doslovno i figurativno. Svako se proširenje naplaćuje zasebno. Izvor ne može premašiti 15 sekundi, što ograničava lanac: počevši od 5 sekundi, sekvenca doseže 20 sekundi nakon tri proširenja od po 5 sekundi, a četvrto bi bilo odbijeno. Vizualna koherencija se degradira kroz lance, jer svaki korak oslanja na već interpretirani izlaz: nakon tri ili četiri lančano povezana proširenja, postaju vidljiva odstupanja u boji i morfologiji. I kao svugdje u ovom API-ju, URL-ovi su privremeni—preuzmi svaku međufazu, inače će te neuspjeh na kraju lanca prisiliti da kreneš ispočetka.
Duo generiranje pa proširenje
Najčešći uzorak u produkciji kombinira oba endpointa. Prvo generiraš kratku bazu od 3 sekunde s vrlo preciznim promptom, putem POST /v1/videos/generations, što ti omogućuje iteraciju nad početnom estetikom uz niže troškove. Zatim dodaješ 5 sekundi razvoja putem POST /v1/videos/extensions, a zatim 4 sekunde zaključka putem drugog poziva istom endpointu. Rezultat je video od 12 sekundi izgrađen segment po segment, gdje je svaki dio validiran prije nego što je započet sljedeći—kontrola koju nijedno pojedinačno generiranje od 12 sekundi ne bi ponudilo.
Ključne točke
- Proširenje produljuje video od 2 do 15 sekundi segmentom od 2 do 10 sekundi (zadano 6) i vraća kompletan video
- Izvorni video ide u objekt
video(urlilifile_id), kao i kod uređivanja; Python SDK ga prima kaovideo_url - Lančano povezivanje omogućuje stvaranje dugih sekvenci korak po korak
- Koherencija se degradira nakon 3-4 uzastopna proširenja
- Kombiniraj početno generiranje + proširenja za preciznu kontrolu sadržaja