Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Strihanie videa pomocou /v1/videos/edits

Lekcia 7 z 12 Aktualizované 3. novembra 2026 Mierne pokročilý
Na tejto strane
  1. Úprava existujúceho videa
  2. Koncový bod POST /v1/videos/edits
  3. O čo požiadať pri úprave
  4. Asynchrónny cyklus, identický ako pri generovaní
  5. Urči, čo sa mení a čo zostáva
  6. Kľúčové poznatky

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 video ako 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ť.

8.7 s
Maximálna dĺžka zdroja
720p
Maximálne rozlíšenie
H.265
Akceptovaný kodek (napr. H.264, AV1)
MP4
Požadovaný formát

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/edits upravuje existujúce video na základe promptu, a to výlučne pomocou grok-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_ratio ani resolution
  • Uveď, čo sa má zmeniť, a potom, čo musí zostať identické