Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Videóhosszabbítás a /v1/videos/extensions végponttal

8. lecke 12 közül Frissítve 2026. november 2. Középhaladó
Ezen az oldalon
  1. Egy meglévő videó hosszabbítása
  2. A POST /v1/videos/extensions végpont
  3. Három módszer egy jelenet folytatására
  4. Hosszabbítások láncolása egy szekvencia felépítéséhez
  5. A generálás és hosszabbítás párosa
  6. Főbb megállapítások

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 video objektumban kapja meg ({"url": ...}), pontosan úgy, mint a szerkesztés – a korábbi szöveg az ellenkezőjét állította –, az eredményt pedig a video.url cí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.

SzempontSzerkesztés (/edits)Hosszabbítás (/extensions)
CélkitűzésTartalom módosításaIdőtartam növelése
Videó paramétervideo objektum (url vagy file_id)video objektum (url vagy file_id)
Forrás időtartamaMax. 8,7 mp2–15 mp
Kimenet időtartamaUgyanaz, mint a forrás (Max. 720p)Forrás + 2–10 mp
Eredeti tartalomMódosítjaMegő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 video objektumba kerül (url vagy file_id), akárcsak a szerkesztésnél; a Python SDK ezt video_url paramé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