Kombinace úprav a prodlužování
Na této stránce
Aktualizováno 2. listopadu 2026. Na základě reference API pro videa od xAI: zdrojový obrázek se vkládá do objektu
imagea video k úpravě nebo prodloužení do objektuvideo({"url": ...}), a to jak pro prodlužování, tak pro úpravy. Zdroje: Prodlužování videa · Reference k videím.
Pokročilé produkční pipeline
Použity izolovaně mají jednotlivé endpointy svá omezení: generování končí na 15 sekundách, úprava zvládne 8,7 sekundy zdroje a prodloužení přidá maximálně 10 sekund. V kombinaci však tvoří produkční pipeline, které tyto limity dalece překonávají a co je klíčové, poskytují ti kontrolní bod po každém segmentu. Tato lekce pokrývá tři reálné pipeline od produktových klipů po stylové variace a ukazuje, jak je udělat spolehlivými.
Pipeline 1: 15sekundová produktová reklama
Scénář je klasický: máš fotografii smartphonu a potřebuješ dodat 15sekundové promo video. Pipeline se staví ze tří 5sekundových segmentů, přičemž každý se před pokračováním validuje.
První segment animuje produktovou fotku – rotace, hra odlesků – pomocí image-to-video, které jsme studovali v předchozí sekci.
{
"model": "grok-imagine-video",
"prompt": "Elegant rotation of the smartphone on a dark background, light reflections on the screen",
"image": {"url": "https://exemple.com/smartphone.jpg"},
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Druhý segment tento záběr prodlouží tak, že přiblíží kameru k obrazovce, přičemž znovu využije URL získanou v předchozím kroku.
{
"model": "grok-imagine-video",
"prompt": "Progressive zoom towards the smartphone screen turning on, displaying a colorful interface",
"video": {"url": "{url_video_etape_1}"},
"duration": 5
}
Třetí segment sekvenci uzavře širokým záběrem, přičemž tentokrát vychází z výstupu druhého segmentu.
{
"model": "grok-imagine-video",
"prompt": "Zoom out revealing the smartphone placed on a design desk, soft light, slight background blur",
"video": {"url": "{url_video_etape_2}"},
"duration": 5
}
Patnáct sekund nového obsahu za cenu 0,05 $ za sekundu s modelem grok-imagine-video: očekávej přibližně 0,75 $ bez iterací, pokud je každý segment fakturován podle své délky. Skutečná cena každého kroku se objeví v poli usage.cost_in_usd_ticks jeho výsledku: ověř si to na testovací pipeline před rozpočtováním celé série.
Pipeline 2: Pět obsahů, jeden styl
Jiná situace, jiná logika: potřebuješ vyrobit pět 5sekundových videí pro sociální kampaň s konzistentním vizuálním stylem. Zde práci nestrukturuje řetězení, ale referenční obrázky, které jsou pro všechna generování stejné. Pět promptů popisuje různé scény; styl zůstává konzistentní díky stejným dvěma vizuálům.
references = [
{"url": "https://exemple.com/style-campagne-1.jpg"},
{"url": "https://exemple.com/style-campagne-2.jpg"}
]
prompts = [
"Coffee pouring into a white ceramic cup, rising steam",
"Hands typing on a keyboard, blurred screen in background",
"An open notebook with a pen writing, natural light",
"A green plant growing in timelapse in a clay pot",
"A book whose pages turn in the wind on a terrace"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/generations",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"reference_images": references,
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p"
}
)
Pět 5sekundových klipů vyjde na 1,25 $. Všimni si formátu 9:16 aplikovaného na všechny požadavky: pro vertikální kampaň je to typický oversight, který tě stojí kompletní regeneraci.
Pipeline 3: Odvozování variant z videa
Třetí schéma nic neřetězí: aplikuje několik různých úprav paralelně na stejné zdrojové video. Získáš tak čtyři verze téhož klipu, které můžeš nabídnout pro A/B testování nebo distribuovat na platformy s odlišnou identitou.
video_source = "https://exemple.com/video-base.mp4"
variations = [
"Cinematic black and white style, film grain",
"Pop art saturated colors, strong contrasts",
"Night ambiance, purple and blue neon lights",
"Watercolor style, soft outlines and washed colors"
]
for variation in variations:
resp = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": variation,
"video": {"url": video_source}
}
)
Tyto tři pipeline využívají čtyři endpointy, které jsou shrnuty níže.
| Endpoint | Metoda | Vstup | Výstup | Max. délka |
|---|---|---|---|---|
/v1/videos/generations | POST | Prompt + možnosti | Nové video | 1–15 s |
/v1/videos/edits | POST | Video + prompt | Upravené video | Zdroj až 8,7 s |
/v1/videos/extensions | POST | Video + prompt | Prodloužené video | +2 až 10 s, zdroj až 15 s |
/v1/videos/{id} | GET | request_id | Stav + URL | - |
Jak udělat řetězec odolným vůči selhání
Jakmile začneš operace řetězit, pravděpodobnost, že alespoň jedna selže, se stává významnou, a selhání na třetím článku znamená ztrátu prvních dvou, pokud nic neplánuješ. Následující funkce zapouzdří každý krok do smyčky s opakovanými pokusy a postoupí k dalšímu kroku, pouze pokud je získána URL.
async def pipeline_with_retry(steps, max_retries=2):
video_url = None
for i, step in enumerate(steps):
for attempt in range(max_retries + 1):
try:
if step["type"] == "generation":
result = await generate_video(step["params"])
elif step["type"] == "extension":
step["params"]["video"] = {"url": video_url}
result = await extend_video(step["params"])
elif step["type"] == "edition":
step["params"]["video"] = {"url": video_url}
result = await edit_video(step["params"])
video_url = await wait_for_result(result["request_id"])
break
except Exception as e:
if attempt == max_retries:
raise Exception(f"Step {i+1} failed: {e}")
await asyncio.sleep(10)
return video_url
Kolem této kostry existuje pět návyků, které dělají rozdíl mezi prototypem a službou. Stahuj výsledek v každém kroku, protože URL jsou dočasné a obnova po incidentu vyžaduje mít meziverze. Vizualně validuj každý segment před pokračováním k dalšímu, jinak zaplatíš za tři generování, jen abys zjistil, že první nebylo vhodné. Chyby řeš pokusy oddělenými exponenciálním backoffem. Před spuštěním dlouhého řetězce si spočítej celý rozpočet včetně pravděpodobných iterací. A paralelizuj, co jde: v pipeline 2 a pipeline 3 žádné generování nezávisí na jiném, takže mohou běžet současně.
Ceny ověřeny 3. listopadu 2026 — ceny se pravidelně mění: před jakýmkoli výpočtem rozpočtu zkontroluj aktuální sazby na oficiální stránce modelů a cen xAI.
Klíčové poznatky
- Tři endpointy (generování, úpravy, prodlužování) se kombinují do pipeline
- Referenční obrázky zajišťují stylovou konzistenci napříč více videi
- Iterativní úpravy umožňují odvodit z videa několik verzí
- Stahuj průběžné výsledky a řeš chyby v každém kroku
- Před spuštěním složitých pipeline si spočítej celkový rozpočet