Videószerkesztés a /v1/videos/edits végponttal
Ezen az oldalon
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
videoobjektumot 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.
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/editsvégpont egy meglévő videót módosít egy utasítás alapján, kizárólag agrok-imagine-videomodellel - 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_ratiovagyresolutionmező - Mondd ki, minek kell változnia, majd annak, minek kell azonosnak maradnia