Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Úprava videa pomocí /v1/videos/edits

Lekce 7 z 12 Aktualizováno 3. listopadu 2026 Mírně pokročilý
Na této stránce
  1. Úprava existujícího videa
  2. Koncový bod POST /v1/videos/edits
  3. Co požadovat při úpravě
  4. Asynchronní cyklus, totožný s generováním
  5. Urči, co se mění a co zůstává
  6. Klíčové poznatky

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 video jako ú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.

8,7 s
Maximální délka zdroje
720p
Maximální rozlišení
H.265
Akceptovaný kodek (např. H.264, AV1)
MP4
Požadovaný formát

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/edits upravuje existující video na základě promptu, a to pouze s modelem grok-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_ratio ani resolution
  • Řekni, co se má změnit, a poté, co musí zůstat identické