Strihanie videa pomocou /v1/videos/edits
Na tejto strane
Aktualizované 3. novembra 2026. Na základe stránky Video Editing od xAI: zdrojové video má maximálnu dĺžku 8,7 sekundy, výstup si zachováva svoju dĺžku, pomer strán a rozlíšenie (maximálne 720p) a rozširovanie využíva rovnaký objekt
videoako strihanie. Predchádzajúce tvrdenie, že strihanie je nespoľahlivé pre konkrétne prvky, je v rozpore s príkladmi xAI, ktoré sa zameriavajú práve na presné úpravy. Zdroje: Video Editing · Video Overview.
Úprava existujúceho videa
Generovanie je len časťou práce. API xAI tiež poskytuje koncový bod video editing (strihanie videa), ktorý vezme existujúcu sekvenciu a upraví ju na základe textových promptov. Je to video ekvivalent úpravy obrázkov, ale s prísnejšími obmedzeniami formátu. Predtým, ako napíšeš svoju prvú požiadavku, uvedom si štyri hranice, ktoré určujú, čo môžeš odoslať.
Koncový bod POST /v1/videos/edits
Požiadavka spája zdrojové video s promptom opisujúcim požadovanú úpravu.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Stačia tri polia: model, ktorý zostáva grok-imagine-video; prompt, ktorý obsahuje opis úpravy; a video.url, ktoré odkazuje na súbor MP4 na spracovanie. Všimni si, že video je zabalené v objekte video, ktorý akceptuje buď url, alebo file_id nahraného súboru: koncový bod pre rozširovanie, o ktorom bude reč v ďalšej lekcii, používa rovnakú konvenciu.
Technické obmedzenia sú tu prísnejšie než pri generovaní. Zdroj nesmie presiahnuť 8,7 sekundy a vytvorené video si zachováva svoju dĺžku; stránka Video Generation spomína dĺžku „obmedzenú na 8,7 sekundy“ bez podrobností o spracovaní dlhšieho zdroja: preto si svoje zdroje vopred orež. Rozlíšenie je obmedzené na 720p. Vstupný súbor musí byť MP4 v podporovanom kodeku, ako sú H.264, H.265 alebo AV1. Najmatúcejším bodom pre tých, ktorí prichádzajú z generovania, je fakt, že nemáš žiadnu kontrolu nad dĺžkou, pomerom strán ani rozlíšením výstupu; všetky tieto parametre určuje zdrojové video. Požiadavka na úpravu neobsahuje žiadne pole duration, aspect_ratio ani resolution.
O čo požiadať pri úprave
Nahradenie pozadia je učebnicovým prípadom: subjekt zostáva, prostredie sa mení.
{
"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"}
}
Zmeny štýlu ovplyvňujú celý obraz a transformujú štýl klipu bez zmeny jeho akcie – praktické na adaptáciu tej istej sekvencie do rôznych univerzov.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
Pridanie prvkov obohacuje scénu o vrstvy, ktoré počas natáčania neexistovali, zvyčajne atmosférické.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Nakoniec, úprava osvetlenia znamená prehodnotenie sekvencie: rovnaké zábery, radikálne 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"}
}
Asynchrónny cyklus, identický ako pri generovaní
Strihanie presne dodržiava rovnaký štvorkrokový protokol ako generovanie: odošleš požiadavku, dostaneš request_id, pravidelne zisťuješ stav pomocou GET /v1/videos/{request_id} a stiahneš upravené video, keď sa stav zmení na done. V Pythone prvé dva kroky zaberie pár riadkov.
import httpx
# 1. Odoslanie ú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. Zisťovanie stavu (zjednodušené)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Urči, čo sa mení a čo zostáva
xAI opisuje správanie modelu jednou vetou: grok-imagine-video aplikuje požadovanú zmenu a všetko ostatné udržia čo najbližšie k zdroju. Jeho dokumentácia z toho odvodzuje usmernenie: povedz tiež, čo musí zostať identické. Jeho vlastné príklady sa tiež zameriavajú na presné úpravy jedného klipu – pridanie strieborného náhrdelníka, zmena outfitu na červenú, nasadenie čierneho klobúka so širokou obrubou postave – spustené paralelne na tom istom 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íručka promptov pre obrázky od xAI, napísaná pre statické obrázky, špecifikuje poradie, ktoré funguje: najprv úprava, potom veta, ktorá uzamkne to, čo zostáva statické. Úprava, ktorá začína slovami „zachovaj všetko“, zmení takmer nič, a úprava, ktorá kopíruje celý prompt na generovanie, scénu úplne reinventuje.
Štyri návyky ti pomôžu vyhnúť sa väčšine úskalí: udržuj svoje zdroje pod 8,7 sekundy v podporovanom kodeku (H.264, H.265 alebo AV1); pomenuj, čo musí zostať nedotknuté; otestuj úpravu na krátkom klipe pred jej rozšírením; a pamätaj, že strihanie využíva grok-imagine-video, ktorého cenník zobrazuje jednotnú sadzbu 0,050 USD za sekundu – kolo testov stojí rovnako ako generovanie.
Kľúčové poznatky
- Koncový bod
POST /v1/videos/editsupravuje existujúce video na základe promptu, a to výlučne pomocougrok-imagine-video - Zdroj má maximálnu dĺžku 8,7 sekundy; výstup si zachováva svoju dĺžku, pomer a rozlíšenie (maximálne 720p)
- Zdrojové video musí byť MP4 v podporovanom kodeku (H.264, H.265, AV1)
- Požiadavka neobsahuje žiadne pole
duration,aspect_ratioaniresolution - Uveď, čo sa má zmeniť, a potom, čo musí zostať identické