Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Videószerkesztés a /v1/videos/edits végponttal

7. lecke 12 közül Frissítve 2026. november 3. Középhaladó
Ezen az oldalon
  1. Meglévő videó szerkesztése
  2. A POST /v1/videos/edits végpont
  3. Mit kérj egy szerkesztés során?
  4. Az aszinkron ciklus, amely megegyezik a generálással
  5. Fogalmazd meg, mi változik és mi marad
  6. Főbb megállapítások

Frissítve: 2026. november 3. Az xAI Videószerkesztés oldala alapján: a forrásvideó hossza legfeljebb 8,7 másodperc, a kimenet megtartja az eredeti időtartamot, képarányt és felbontást (max. 720p), a kiterjesztés pedig ugyanazt a video objektumot használja, mint a szerkesztés. A korábbi állítás, miszerint a szerkesztés megbízhatatlan lenne specifikus elemek esetén, ellentmond az xAI példáinak, amelyek kifejezetten a precíz módosításokra fókuszálnak. Források: Videószerkesztés · Videó áttekintés.

Meglévő videó szerkesztése

A generálás csak a munka egy része. Az xAI API egy videószerkesztő végpontot is biztosít, amely egy meglévő szekvenciát fogad el, és szöveges utasítások alapján módosítja azt. Ez a képszerkesztés video megfelelője, szigorúbb formátumi korlátokkal. Mielőtt megírnád az első kérésedet, jegyezd meg azt a négy határvonalat, amely meghatározza, mit küldhetsz be.

8.7 s
Maximális forrásidőtartam
720p
Maximális felbontás
H.265
Elfogadott kodek (pl. H.264, AV1)
MP4
Kötelező formátum

A POST /v1/videos/edits végpont

A kérés egy forrásvideót párosít egy kívánt módosítást leíro utasítással.

{
  "model": "grok-imagine-video",
  "prompt": "Change the background to a sunset over the ocean",
  "video": {
    "url": "https://example.com/original-video.mp4"
  }
}

Három mező elegendő: a model, amely mindig grok-imagine-video marad; a prompt, amely tartalmazza a módosítás leírását; valamint a video.url, amely a feldolgozandó MP4 fájlra mutat. Figyeld meg, hogy a videó egy video objektumba van ágyazva, amely elfogad egy url-t vagy egy feltöltött fájl file_id-jét: a következő leckében tárgyalt kiterjesztési végpont ugyan ezt a konvenciót követi.

A technikai korlátok itt szigorúbbak, mint a generálásnál. A forrás nem haladhatja meg a 8,7 másodpercet, és a létrehozott videó megtartja ezt az időtartamot; a Videógenerálás oldal egy „legfeljebb 8,7 másodpercre korlátozott“ időtartamot említ anélkül, hogy részletezné a hosszabb források kezelését: ezért vágd előre a forrásaidat. A felbontás maximum 720p lehet. A bemeneti fájlnak MP4-nek kell lennie egy támogatott kodekkel, például H.264, H.265 vagy AV1 formátumban. A legzavaróbb pont a generálásból érkezők számára: nincs ráhatásod a kimenet időtartamára, képarányára vagy felbontására, ezeket mind a forrásvideó határozza meg. A szerkesztési kérésben nincs duration, aspect_ratio vagy resolution mező.

Mit kérj egy szerkesztés során?

A háttércsere a tankönyvi példa: az alany marad, a környezet változik.

{
  "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"}
}

A stílusváltások az egész képet érintik, és átalakítják a klip stílusát anélkül, hogy megváltoztatnák a cselekményt – ez gyakorlati megoldás ugyanazon szekvencia különböző univerzumokba való adaptálására.

{
  "model": "grok-imagine-video",
  "prompt": "Transform this video into a Japanese cartoon style with vivid colors",
  "video": {"url": "https://example.com/video.mp4"}
}

Az elemek hozzáadása olyan rétegekkel gazdagítja a jelenetet, amelyek a forgatás során nem voltak jelen, általában légköri hatásokat létrehozva.

{
  "model": "grok-imagine-video",
  "prompt": "Add falling snow and a frost effect on the edges",
  "video": {"url": "https://example.com/video.mp4"}
}

Végül a világítás módosítása a szekvencia újrahangolásával egyenlő: ugyanazok a beállítások, gyökeresen más hangulat.

{
  "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"}
}

Az aszinkron ciklus, amely megegyezik a generálással

A szerkesztés pontosan ugyanazt a négy lépésből álló protokollt követi, mint a generálás: elküldöd a kérést, kapsz egy request_id-t, rendszeres időközönként lekérdezed a GET /v1/videos/{request_id} végpontot, és letöltöd a szerkesztett videót, amikor az állapot done-ra változik. Pythonban az első két lépés néhány sorba belefér.

import httpx

# 1. A szerkesztés beküldése
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. Az állapot lekérdezése (egyszerűsítve)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Fogalmazd meg, mi változik és mi marad

Az xAI egy mondatban írja le a modell viselkedését: a grok-imagine-video alkalmazza a kért változtatást, és mindent a lehető legközelebb tart a forráshoz. Dokumentációjuk ebből vezet le egy irányelvet: azt is mondd ki, minek kell változatlannak maradnia. Saját példáik is egyetlen klip precíz szerkesztéseire fókuszálnak – ezüst nyaklánc hozzáadása, egy ruha pirosra cserélése, egy fekete széles karimájú kalap feltevése egy karakterre –, amelyek ugyanazon a forráson futnak párhuzamosan.

{
  "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"}
}

Az xAI képfelirat-útmutatója, amelyet állóképekhez írtak, meghatározza a működő sorrendet: először a módosítás, majd egy mondat, amely rögzíti, mi marad statikus. Egy olyan szerkesztés, amely a „minden maradjon“ kezdetű utasítással indul, szinte semmit sem változtat, míg egy olyan, amely egy teljes generálási utasítást másol, újraalkotja a jelenetet.

Négy szokás segít elkerülni a legtöbb buktatót: tartsd a forrásaidat 8,7 másodperc alatt, támogatott kodekkel (H.264, H.265 vagy AV1); nevezd meg, minek kell érintetlennek maradnia; tesztelj egy módosítást egy rövid klippen, mielőtt nagyobbra méreteznéd; és ne feledd, hogy a szerkesztés a grok-imagine-video modellt használja, amelynek árazási táblázata egyetlen díjat mutat: másodpercenként 0,050 USD – egy kör próba ugyanannyiba kerül, mint a generálás.

Főbb megállapítások

  • A POST /v1/videos/edits végpont egy meglévő videót módosít egy utasítás alapján, kizárólag a grok-imagine-video modellel
  • A forrás legfeljebb 8,7 másodperc hosszú; a kimenet megtartja az időtartamot, az arányt és a felbontást (max. 720p)
  • A forrásvideónak MP4-nek kell lennie egy támogatott kodekkel (H.264, H.265, AV1)
  • A kérésben nincs duration, aspect_ratio vagy resolution mező
  • Mondd ki, minek kell változnia, majd annak, minek kell azonosnak maradnia