Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Rozšíření videa pomocí /v1/videos/extensions

Lekce 8 z 12 Aktualizováno 2. listopadu 2026 Mírně pokročilý
Na této stránce
  1. Rozšíření existujícího videa
  2. Endpoint POST /v1/videos/extensions
  3. Tři způsoby, jak pokračovat ve scéně
  4. Řetězení rozšíření pro vytvoření sekvence
  5. Dvojice generování a následné rozšíření
  6. Klíčové poznatky

Lekce aktualizována 2. listopadu 2026 na základě reference xAI Video API: rozšíření přijímá video v objektu video ({"url": ...}), přesně jako při úpravách – předchozí text tvrdil opak – výsledek se čte z video.url a zdroj je omezen na 15 sekund. Zdroje: Video Extension · Video Reference.

Rozšíření existujícího videa

Zatímco úprava transformuje sekvenci beze změny její délky, rozšíření dělá přesný opak: prodlužuje video vygenerováním pokračování, které navazuje na to předchozí. Řeší to nejčastější problém při generování videa – úspěšný klip, který je příliš krátký, nebo scénu, která si zaslouží rozvinutí beyond svou původní dobu trvání. Místo abys generoval vše znovu a doufal, že znovu vytvoříš stejný vzhled, vycházíš z toho, co již existuje, a pokračuješ dál.

Endpoint POST /v1/videos/extensions

Požadavek připomíná žádost o generování, pouze s přidaným počátečním videem.

{
  "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 zůstává grok-imagine-video, prompt popisuje, co se má dít v pokračování, objekt video určuje video k rozšíření (buď url, nebo file_id nahraného souboru, pro zdroj o délce 2 až 15 sekund) a duration nastavuje délku rozšíření mezi 2 a 10 sekundami – výchozí hodnota je 6 sekund. Na rozdíl od úprav zde znovu získáváš kontrolu nad délkou. Vrácené video obsahuje originál následovaný rozšířením: 10sekundový zdroj rozšířený o 5 sekund výsledkem 15sekundové video.

Následující tabulka shrnuje rozdíly mezi oběma endpointy, protože záměny jsou časté.

AspektÚpravy (/edits)Rozšíření (/extensions)
CílUpravit obsahPřidat délku
Parametr videaObjekt video (url nebo file_id)Objekt video (url nebo file_id)
Délka zdrojeMax 8,7 s2 až 15 s
Délka výstupuStejná jako zdroj (Max 720p)Zdroj + 2 až 10 s
Původní obsahUpravujeZachovává

Oba endpointy REST API přijímají video stejným způsobem, v objektu video s vlastností url. Python SDK jej však přijímá jako parametr video_url: tento název parametru nekopíruj do těla JSON, API jej nerozpozná. To, co skutečně odlišuje oba endpointy, je délka.

Tři způsoby, jak pokračovat ve scéně

Nejjednodušší případ spočívá v tom, že necháš probíhající akci plynule pokračovat. Prompt navazuje na aktuální dění a prodlužuje jej bez přerušení.

{
  "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š také zavést změnu, což znamená přidat nový prvek nebo změnit směr pohledu. To dodává sekvenci narativní spád.

{
  "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
}

Třetím případem použití je závěr: krátké rozšíření, které čistě uzavře sekvenci, často s prolínáním do černé.

{
  "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
}

Řetězení rozšíření pro vytvoření sekvence

Nic ti nebrání rozšiřovat video vícekrát za sebou. Každé rozšíření vytvoří nové video, jehož URL může sloužit jako zdroj pro další rozšíření, což ti umožňuje budovat dlouhou sekvenci prostřednictvím po sobě jdoucích segmentů, z nichž každý je řízen vlastním promptem. Níže uvedený skript řetězí tři rozšíření opětovným vložením získaného URL v každém 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}")

Tato elegance má svou cenu, doslova i obrazně. Každé rozšíření je účtováno samostatně. Zdroj nesmí překročit 15 sekund, což omezuje řetězec: pokud začneš s 5 sekundami, sekvence dosáhne po třech 5sekundových rozšířeních 20 sekund a čtvrté bude odmítnuto. Vizuální koherence se v rámci odkazů zhoršuje, protože každý krok vychází z již interpretovaného výstupu: po více než třech nebo čtyřech řetězených rozšířeních se stanou viditelnými posuny v barvách a morfologii. A jako všude v tomto API jsou URL dočasné – stahuj každou průběžnou verzi, jinak tě selhání na konci řetězce donutí začít znovu od začátku.

Dvojice generování a následné rozšíření

Nejběžnější vzor v produkci kombinuje oba endpointy. Nejprve vygeneruješ krátký 3sekundový základ s velmi přesným promptem pomocí POST /v1/videos/generations, což ti umožňuje iterovat na počáteční estetice za nižší cenu. Poté přidáš 5 sekund vývoje pomocí POST /v1/videos/extensions a následně 4 sekundy závěru druhým voláním stejného endpointu. Výsledkem je 12sekundové video postavené segment po segmentu, kde byla každá část ověřena před tím, než se přešlo k další – kontrola, kterou žádné jediné 12sekundové generování nenabízí.

Klíčové poznatky

  • Rozšíření prodlužuje video o délce 2 až 15 sekund o segment dlouhý 2 až 10 sekund (výchozí 6) a vrací kompletní video
  • Zdrojové video se vkládá do objektu video (url nebo file_id), stejně jako při úpravách; Python SDK jej přijímá jako video_url
  • Řetězení umožňuje vytvářet dlouhé sekvence krok za krokem
  • Koherence se zhoršuje po více než 3–4 po sobě jdoucích rozšířeních
  • Kombinuj počáteční generování s rozšířeními pro přesnou kontrolu obsahu