Rozšírenie videa pomocou /v1/videos/extensions
Na tejto strane
Lekcia aktualizovaná 2. novembra 2026 na základe referencie xAI Video API: rozšírenie prijíma video v objekte
video({"url": ...}), presne ako pri úpravách – predchádzajúci text tvrdil opak – výsledok sa číta zvideo.urla zdroj je obmedzený na 15 sekúnd. Zdroje: Rozšírenie videa · Referencia videa.
Rozšírenie existujúceho videa
Kým úprava transformuje sekvenciu bez zmeny jej dĺžky, rozšírenie robí presný opak: predlžuje video vygenerovaním pokračovania, ktoré je konzistentné s tým, čo mu predchádzalo. Rieši to najčastejší problém pri generovaní videa – úspešný klip, ktorý je príliš krátky, alebo scéna, ktorá si zaslúži rozvinutie nad rámec svojej pôvodnej dĺžky. Namiesto opätovného generovania celého obsahu a dúfania, že sa podarí znovu vytvoriť rovnaký vzhľad, vychádzaš z toho, čo už existuje, a pokračuješ ďalej.
Endpoint POST /v1/videos/extensions
Požiadavka sa podobá na požiadavku generovania, s tým rozdielom, že obsahuje počiatočné video.
{
"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
}
Pole model zostáva grok-imagine-video, prompt opisuje, čo sa má diať v pokračovaní, objekt video špecifikuje video na rozšírenie (url alebo file_id nahraného súboru, pre zdroj s dĺžkou 2 až 15 sekúnd) a duration nastavuje dĺžku rozšírenia medzi 2 a 10 sekundami – predvolená hodnota je 6 sekúnd. Na rozdiel od úprav tu získavaš späť kontrolu nad dĺžkou. Vrátene video obsahuje originál nasledovaný rozšírením: 10-sekundový zdroj rozšírený o 5 sekúnd výsledkom 15-sekundové video.
Nasledujúca tabuľka zhrňuje rozdiely medzi týmito dvoma endpointmi, keďže dochádza k častým zámenám.
| Aspekt | Úpravy (/edits) | Rozšírenie (/extensions) |
|---|---|---|
| Cieľ | Úprava obsahu | Pridanie dĺžky |
| Parameter videa | Objekt video (url alebo file_id) | Objekt video (url alebo file_id) |
| Dĺžka zdroja | Max 8,7 s | 2 až 15 s |
| Dĺžka výstupu | Rovnaká ako zdroj (Max 720p) | Zdroj + 2 až 10 s |
| Pôvodný obsah | Upravuje | Zachováva |
Oba endpointy REST API prijímajú video rovnakým spôsobom, v objekte video s vlastnosťou url. Python SDK ho však prijíma ako parameter video_url: tento názov parametra nekopíruj do tela JSON, API ho nerozozná. To, čo skutočne odlišuje tieto dva endpointy, je dĺžka trvania.
Tri spôsoby pokračovania scény
Najjednoduchší prípad spočíva v tom, že necháš pokračovať to, čo sa už deje. Prompt nadväzuje na aktuálnu akciu a rozširuje ju bez prerušenia.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Môžeš tiež zaviesť zmenu, čo znamená priniesť nový prvok alebo zmeniť smer pohľadu. To dodáva sekvencii jej naratívny 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
}
Tretím prípadom použitia je záver: krátke rozšírenie, ktoré čistým spôsobom uzatvára sekvenciu, často s postupným stmavnutím.
{
"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
}
Reťazenie rozšírení na vytvorenie sekvencie
Nič ti nebráni rozširovať video viackrát za sebou. Každé rozšírenie vytvorí nové video, ktorého URL môže slúžiť ako zdroj pre ďalšie rozšírenie, čo ti umožňuje budovať dlhú sekvenciu prostredníctvom postupných segmentov, pričom každý je riadený vlastným promptom. Nasledujúci skript reťazí tri rozšírenia opätovným vložením získanej URL v každom kroku.
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}")
Táto elegancia má svoju cenu, doslovne aj obrazne. Každé rozšírenie sa fakturuje samostatne. Zdroj nesmie presiahnuť 15 sekúnd, čo obmedzuje reťazenie: ak začneš s 5 sekundami, sekvencia dosiahne po troch 5-sekundových rozšíreniach 20 sekúnd a štvrté bude odmietnuté. Vizuálna koherencia sa v rámci článkov zhoršuje, pretože každý krok sa spolieha na už interpretovaný výstup: po viac ako troch alebo štyroch reťazených rozšíreniach sa stanú viditeľnými posuny vo farbách a morfológii. A ako všade v tomto API, URL adresy sú dočasné – stiahni si každú priebežnú verziu, inak ťa zlyhanie na konci reťaze donúti začať úplne od začiatku.
Duo generovanie a následné rozšírenie
Najbežnejší vzor v produkcii kombinuje oba endpointy. Najprv vygeneruješ krátke 3-sekundové základné video s veľmi presným promptom pomocou POST /v1/videos/generations, čo ti umožňuje iterovať nad počiatočnou estetikou pri nižších nákladoch. Následne pridáš 5 sekúnd rozvoja pomocou POST /v1/videos/extensions a potom 4 sekundy záveru pomocou druhého volania toho istého endpointu. Výsledkom je 12-sekundové video zostavené segment po segmente, kde bola každá časť overená predtým, než sa pokračovalo ďalej – úroveň kontroly, ktorú by neposkytlo žiadne jednorazové generovanie 12-sekundového videa.
Kľúčové poznatky
- Rozšírenie predlžuje video s dĺžkou 2 až 15 sekúnd o segment s dĺžkou 2 až 10 sekúnd (predvolené 6) a vracia kompletné video
- Zdrojové video sa uvádza v objekte
video(urlalebofile_id), rovnako ako pri úpravách; Python SDK ho prijíma akovideo_url - Reťazenie umožňuje vytvárať dlhé sekvencie krok za krokom
- Koherencia sa zhoršuje po viac ako 3–4 po sebe idúcich rozšíreniach
- Kombinuj počiatočné generovanie s rozšíreniami pre presnú kontrolu obsahu