Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Proširenje videa s /v1/videos/extensions

Lekcija 8 od 12 Ažurirano 2. studenoga 2026. Srednja razina
Na ovoj stranici
  1. Proširivanje postojećeg videa
  2. POST /v1/videos/extensions endpoint
  3. Tri načina za nastavak scene
  4. Lančano povezivanje proširenja za izgradnju sekvence
  5. Duo generiranje pa proširenje
  6. Ključne točke

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 iz video.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.

AspektUređivanje (/edits)Proširenje (/extensions)
CiljModificiranje sadržajaDodavanje trajanja
Parametar videaObjekt video (url ili file_id)Objekt video (url ili file_id)
Trajanje izvoraMaks. 8,7 s2 do 15 s
Trajanje izlazaIsto kao izvor (Maks. 720p)Izvor + 2 do 10 s
Originalni sadržajModificiraČ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 (url ili file_id), kao i kod uređivanja; Python SDK ga prima kao video_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