Úprava videa pomocí /v1/videos/edits
Na této stránce
Aktualizováno 3. listopadu 2026. Na základě stránky Video Editing od xAI: zdrojové video má maximální délku 8,7 sekundy, výstup si zachovává svou délku, poměr stran a rozlišení (max. 720p) a rozšiřování využívá stejný objekt
videojako úpravy. Předchozí tvrzení, že úpravy jsou pro specifické prvky nespolehlivé, je v rozporu s příklady xAI, které se zaměřují právě na přesné zásahy. Zdroje: Video Editing · Video Overview.
Úprava existujícího videa
Generování je jen část práce. API xAI také poskytuje koncový bod pro úpravu videa, který vezme existující sekvenci a upraví ji na základě textových promptů. Je to videoobdoba úpravy obrázků, ale s přísnějšími omezeními formátu. Než napíšeš svou první žádost, vezmi v úvahu čtyři hranice, které určují, co můžeš odeslat.
Koncový bod POST /v1/videos/edits
Žádost spojuje zdrojové video s promptem popisujícím požadovanou úpravu.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Stačí tři pole: model, které zůstává grok-imagine-video; prompt, který obsahuje popis úpravy; a video.url, které odkazuje na soubor MP4 ke zpracování. Všimni si, že video je zapouzdřeno v objektu video, který přijímá buď url, nebo file_id nahraného souboru: koncový bod pro rozšiřování v další lekci přijímá stejnou konvenci.
Technická omezení jsou zde přísnější než při generování. Zdroj nesmí přesáhnout 8,7 sekundy a vytvořené video si zachovává svou délku; stránka Video Generation zmiňuje délku „omezenou na 8,7 sekundy“, ale nepodrobně řeší zacházení s delším zdrojem: proto si zdroje předem ořízni. Rozlišení je omezeno na 720p. Vstupní soubor musí být MP4 v podporovaném kodeku, jako je H.264, H.265 nebo AV1. Nejmatoucí bod pro ty, kteří přicházejí z generování: nemáš žádnou kontrolu nad délkou, poměrem stran ani rozlišením výstupu, vše je určeno zdrojovým videem. Žádost o úpravu neobsahuje žádné pole duration, aspect_ratio ani resolution.
Co požadovat při úpravě
Nahrazení pozadí je učebnicovým příkladem: subjekt zůstává, prostředí se mění.
{
"model": "grok-imagine-video",
"prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Změny stylu ovlivňují celý obraz a transformují styl klipu bez změny jeho akce – praktické pro adaptaci stejné sekvence do různých vesmírů.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
Přidání prvků obohacuje scénu o vrstvy, které během natáčení neexistovaly, obvykle atmosférické.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Nakonec úprava osvětlení znamená přebarvení sekvence: stejné záběry, radikálně odlišná atmosféra.
{
"model": "grok-imagine-video",
"prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
"video": {"url": "https://example.com/video.mp4"}
}
Asynchronní cyklus, totožný s generováním
Úpravy následují přesně stejný čtyřkrokový protokol jako generování: odešleš žádost, obdržíš request_id, pravidelně dotazuješ GET /v1/videos/{request_id} a stáhneš upravené video, jakmile se stav změní na done. V Pythonu se první dva kroky vejdou do několika řádků.
import httpx
# 1. Odeslání úpravy
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Add a rain effect over the entire scene",
"video": {"url": "https://example.com/source.mp4"}
}
)
request_id = response.json()["request_id"]
# 2. Dotazování na stav (zjednodušeně)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Urči, co se mění a co zůstává
xAI popisuje chování modelu jednou větou: grok-imagine-video aplikuje požadovanou změnu a vše ostatní zachová co nejvěrněji zdroji. Jeho dokumentace z toho odvozuje pokyn: řekni také, co musí zůstat identické. Jeho vlastní příklady se také zaměřují na přesné úpravy jediného klipu – přidání stříbrného náhrdelníku, změna oblečení na červené, nasazení černého klobouku se širokou krempou postavě – běžící paralelně na stejném zdroji.
{
"model": "grok-imagine-video",
"prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Průvodce prompty pro obrázky od xAI, napsaný pro statické obrázky, specifikuje pořadí, které funguje: nejprve úprava, poté věta, která uzamkne to, co zůstává statické. Úprava, která začíná „zachovej vše“, téměř nic nezmění, a úprava, která kopíruje plný prompt pro generování, scénu znovu vymyslí.
Čtyři návyky ti pomohou vyhnout se většině úskalí: udržuj zdroje pod 8,7 sekundy v podporovaném kodeku (H.264, H.265 nebo AV1); pojmenuj, co musí zůstat nedotčeno; otestuj úpravu na krátkém klipu před jejím rozšířením; a pamatuj, že úpravy využívají grok-imagine-video, jehož ceník zobrazuje jednotnou sazbu 0,050 USD za sekundu – kolo testů stojí stejně jako generování.
Klíčové poznatky
- Koncový bod
POST /v1/videos/editsupravuje existující video na základě promptu, a to pouze s modelemgrok-imagine-video - Zdroj trvá maximálně 8,7 sekundy; výstup si zachovává svou délku, poměr a rozlišení (max. 720p)
- Zdrojové video musí být MP4 v podporovaném kodeku (H.264, H.265, AV1)
- Žádost neobsahuje žádné pole
duration,aspect_ratioaniresolution - Řekni, co se má změnit, a poté, co musí zůstat identické