Rozšíření videa pomocí /v1/videos/extensions
Na této stránce
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 zvideo.urla 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íl | Upravit obsah | Přidat délku |
| Parametr videa | Objekt video (url nebo file_id) | Objekt video (url nebo file_id) |
| Délka zdroje | Max 8,7 s | 2 až 15 s |
| Délka výstupu | Stejná jako zdroj (Max 720p) | Zdroj + 2 až 10 s |
| Původní obsah | Upravuje | Zachová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(urlnebofile_id), stejně jako při úpravách; Python SDK jej přijímá jakovideo_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