Kombinovanie úprav a rozširovania
Na tejto strane
Aktualizované 2. novembra 2026. Na základe referencie video API od xAI: zdrojový obrázok sa umiestňuje do objektu
imagea video určené na úpravu alebo rozšírenie do objektuvideo({"url": ...}), a to tak pri rozširovaní, ako aj pri úpravách. Zdroje: Rozširovanie videa · Referencia pre videá.
Pokročilé produkčné pipeline
Každý koncový bod používaný samostatne má svoje obmedzenia: generovanie končí na 15 sekundách, úprava na 8,7 sekundy zdrojového materiálu a rozšírenie pridáva maximálne 10 sekúnd. V kombinácii však tvoria produkčné pipeline, ktoré tieto hranice výrazne prekračujú a čo je kľúčové, poskytujú ti kontrolný bod po každom segmente. Táto lekcia pokrýva tri pipeline z reálnej praxe – od produktových klipov po štýlové variácie – a ukazuje, ako ich urobiť spoľahlivými.
Pipeline 1: 15-sekundová produktová promo videoreklama
Scenár je klasický: máš fotku smartfónu a potrebuješ dodať 15-sekundové promo video. Pipeline sa skladá z troch 5-sekundových segmentov, pričom každý sa overí pred spustením nasledujúceho.
Prvý segment animuje produktovú fotku – rotácia, hra odleskov – pomocou funkcie obraz-na-video, ktorú sme študovali v predchádzajúcej sekcii.
{
"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 toto zábery rozšíri tak, že priblíži kameru k obrazovke, pričom znovu použije URL získanú v predchádzajúcom 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
}
Tretí segment uzavrie sekvenciu celkovým záberom, pričom tentoraz vychádza 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ásť sekúnd nového obsahu za cenu 0,05 $ za sekundu s modelom grok-imagine-video: očakávaj približne 0,75 $ bez iterácií, ak sa každý segment fakturuje podľa svojej dĺžky. Skutočné náklady každého kroku nájdeš v poli usage.cost_in_usd_ticks v jeho výsledku: over si to na testovacej pipeline pred rozpočtovaním série.
Pipeline 2: Päť obsahov, jeden štýl
Iná situácia, iná logika: potrebuješ vyprodukovať päť 5-sekundových videí pre sociálnu kampaň s konzistentným vizuálnym štýlom. Tu prácu neštruktúruje reťazenie, ale referenčné obrázky, ktoré sú pre všetky generovania rovnaké. Päť promptov opisuje rôzne scény; štýl zostáva konzistentný vďaka rovnakej dvojici vizuálov.
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äť 5-sekundových klipov stojí dokopy 1,25 $. Všimni si formát 9:16 aplikovaný na všetky požiadavky: pre vertikálnu kampaň je toto typický prehliadnutý detail, ktorý ťa môže stáť kompletné pregenerovanie.
Pipeline 3: Odvodzovanie variácií z videa
Tretí schéma nič nespája do reťazca: aplikuje niekoľko rôznych úprav paralelne na to isté zdrojové video. Získaš tak štyri verzie toho istého klipu, ktoré môžeš použiť na A/B testovanie alebo distribúciu 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}
}
)
Tieto tri pipeline využívajú štyri koncové body, ktoré sú zhrnuté nižšie.
| Koncový bod | Metóda | Vstup | Výstup | Maximálna dĺžka |
|---|---|---|---|---|
/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 | Rozšírené video | +2 až 10 s, zdroj až 15 s |
/v1/videos/{id} | GET | request_id | Stav + URL | - |
Ako urobiť reťazec odolným voči zlyhaniam
Akonáhle začneš operácie spájať do reťazca, pravdepodobnosť, že aspoň jeden krok zlyhá, sa výrazne zvyšuje. Zlyhanie na treťom článku znamená stratu prvých dvoch, ak nemáš pripravený plán. Nasledujúca funkcia zapuzdruje každý krok do slučky s opakovanými pokusmi a prejde na ďalší krok až po získaní 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
Okolo tejto kostry existuje päť návykov, ktoré robia rozdiel medzi prototypom a plnohodnotnou službou. Stiahni si výsledok po každom kroku, keďže URL adresy sú dočasné a obnova po incidente si vyžaduje mať medziverzie. Vizualne over každý segment pred pokračovaním na ďalší, inak zaplatíš za tri generovania, len aby si zistil, že prvé nebolo vhodné. Chyby ošetruj pokusmi oddelenými exponenciálnym oneskorením (exponential backoff). Pred spustením dlhého reťazca si vypočítaj celý rozpočet vrátane pravdepodobných iterácií. A paralelizuj všetko, čo môžeš: v pipeline 2 a pipeline 3 žiadne generovanie nezávisí od iného, takže môžu bežať súčasne.
Ceny overené 3. novembra 2026 – ceny sa pravidelne menia: pred akýmkoľvek výpočtom rozpočtu si over aktuálne sadzby na oficiálnej stránke modelov a cien xAI.
Kľúčové poznatky
- Tri koncové body (generovanie, úprava, rozširovanie) sa kombinujú do pipeline
- Referenčné obrázky zabezpečujú štýlovú konzistenciu naprieč viacerými videami
- Iteratívne úpravy umožňujú odvodiť z videa niekoľko verzií
- Sťahuj medzivýsledky a ošetruj chyby v každom kroku
- Pred spustením komplexných pipeline si vypočítaj celkový rozpočet