Videóhosszabbítás a /v1/videos/extensions végponttal
Ezen az oldalon
A leckét 2026. november 2-án frissítettük az xAI Video API referenciadokumentációja alapján: a hosszabbítás a videót egy
videoobjektumban kapja meg ({"url": ...}), pontosan úgy, mint a szerkesztés – a korábbi szöveg az ellenkezőjét állította –, az eredményt pedig avideo.urlcímről olvashatod le, míg a forrás maximális hossza 15 másodperc. Források: Video Extension · Video Reference.
Egy meglévő videó hosszabbítása
Míg a szerkesztés átalakítja a szekvenciát anélkül, hogy megváltoztatná annak hosszát, a hosszabbítás pontosan az ellenkezőjét teszi: megnöveli a videó időtartamát egy, az előzményekkel összhangban lévő folytatás generálásával. Ez oldja meg a videógyártás leggyakoribb problémáját: amikor egy sikerült klip túl rövid, vagy egy jelenet megérdemli, hogy a kezdeti időtartamon túl is kifejlődjön. Ahelyett, hogy mindent újrateremtenél abban a reményben, hogy ugyanazt a megjelenést kapod vissza, a meglévő anyagból indulsz ki, és folytatod azt.
A POST /v1/videos/extensions végpont
A kérés hasonlít egy generálási kérésre, kiegészítve a kiindulási videóval.
{
"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
}
A model mező továbbra is grok-imagine-video, a prompt leírja, mi történjen a folytatásban, a video objektum adja meg a hosszabbítandó videót (egy url vagy egy feltöltött fájl file_id-je, 2 és 15 másodperc közötti forráshossz esetén), a duration pedig beállítja a hosszabbítás időtartamát 2 és 10 másodperc között – az alapértelmezett érték 6 másodperc. A szerkesztéssel ellentétben itt visszanyered az irányítást az időtartam felett. A visszakapott videó az eredetit tartalmazza, követve a hosszabbítással: egy 10 másodperces forrás 5 másodperces hosszabbítása egy 15 másodperces videót eredményez.
Az alábbi táblázat összefoglalja, mi választja el a két végpontot, mivel a zavar gyakori.
| Szempont | Szerkesztés (/edits) | Hosszabbítás (/extensions) |
|---|---|---|
| Célkitűzés | Tartalom módosítása | Időtartam növelése |
| Videó paraméter | video objektum (url vagy file_id) | video objektum (url vagy file_id) |
| Forrás időtartama | Max. 8,7 mp | 2–15 mp |
| Kimenet időtartama | Ugyanaz, mint a forrás (Max. 720p) | Forrás + 2–10 mp |
| Eredeti tartalom | Módosítja | Megőrzi |
Mindkét REST API végpont ugyanúgy fogadja a videót: egy video objektumban, url tulajdonsággal. A Python SDK azonban a video_url paraméterként kezeli: ezt a paraméternevet ne másold be egy JSON törzsbe, mert az API nem ismeri fel. Ami igazán megkülönbözteti a két végpontot, az az időtartam kezelése.
Három módszer egy jelenet folytatására
A legegyszerűbb eset, ha hagyod folytatódni azt, ami már történik. A prompt felveszi a jelenlegi cselekményt, és megszakítás nélkül kiterjeszti azt.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Bevezethetsz változást is, ami azt jelenti, hogy új elemet hozol be, vagy megváltoztatod a nézőpont irányát. Ez narratív előrehaladást kölcsönöz a szekvenciának.
{
"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
}
A harmadik felhasználási eset a lezárás: egy rövid hosszabbítás, amely tisztán lezárja a szekvenciát, gyakran elhalványítással (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
}
Hosszabbítások láncolása egy szekvencia felépítéséhez
Semmi akadálya annak, hogy egy videót többször is egymás után hosszabbíts. Minden hosszabbítás egy új videót hoz létre, amelynek URL-je forrásként szolgálhat a következő hosszabbításhoz, így egymást követő szegmenseken keresztül építhetsz fel egy hosszú szekvenciát, ahol minden részt saját prompt vezérel. Az alábbi szkript három hosszabbítást láncol össze úgy, hogy minden lépésben visszacsatolja a kapott URL-t.
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}")
Ennek az eleganciának ára van, szó szerint és átvitt értelemben is. Minden hosszabbítást külön számláznak. A forrás nem haladhatja meg a 15 másodpercet, ami korlátozza a láncot: ha 5 másodpercről indulsz, a szekvencia három darab 5 másodperces hosszabbítás után eléri a 20 másodpercet, és a negyediket már elutasítaná a rendszer. A vizuális koherencia romlik a láncszemek mentén, mivel minden lépés egy már értelmezett kimenetre támaszkodik: három-négy egymást követő hosszabbítás túl a színek és a morfológia elcsúszása válik láthatóvá. És mint ezen API minden területén, az URL-ek ideiglenesek – töltsd le az egyes közbenső verziókat, különben a lánc végén bekövetkező hiba arra kényszerít, hogy az elejéről kezdjed újra az egész folyamatot.
A generálás és hosszabbítás párosa
A gyártásban a leggyakoribb minta mindkét végpont kombinálása. Először generálsz egy rövid, 3 másodperces alapot egy nagyon pontos prompttal a POST /v1/videos/generations végponton keresztül, ami lehetővé teszi, hogy alacsonyabb költséggel iterálj a kezdő esztétikán. Ezután hozzáadsz 5 másodpercnyi fejlődést a POST /v1/videos/extensions végponttal, majd további 4 másodpercnyi lezárást ugyanennek a végpontnak egy második hívásával. Az eredmény egy szegmensenként felépített, 12 másodperces videó, ahol minden részt validáltál, mielőtt a következőbe kezdtél volna – olyan kontroll, amit egyetlen 12 másodperces generálás sosem tudna nyújtani.
Főbb megállapítások
- A hosszabbítás egy 2–15 másodperces videót nyújt meg egy 2–10 másodperces szegmenssel (alapértelmezett 6), és a teljes videót adja vissza
- A forrásvideó egy
videoobjektumba kerül (urlvagyfile_id), akárcsak a szerkesztésnél; a Python SDK eztvideo_urlparaméterként kezeli - A láncolás lehetővé teszi hosszú szekvenciák lépésről lépésre történő létrehozását
- A koherencia 3–4 egymást követő hosszabbítás után romlani kezd
- Kombináld a kezdeti generálást a hosszabbításokkal a tartalom pontos kontrollálásához