Urejanje videoposnetkov z /v1/videos/edits
Na tej strani
Posodobljeno 3. novembra 2026. Na podlagi strani xAI Video Editing: izvorni videoposnetek je dolg največ 8,7 sekunde, izhod ohrani njegovo trajanje, razmerje stranic in ločljivost (največ 720p), razširjanje pa uporablja isti predmet
videokot urejanje. Prejšnja trditev, da je urejanje nezanesljivo za specifične elemente, je v nasprotju s primeri xAI, ki se osredotočajo prav na natančne urejanja. Viri: Video Editing · Video Overview.
Urejanje obstoječega videoposnetka
Ustvarjanje je le del dela. API xAI ponuja tudi končno točko za urejanje videoposnetkov, ki sprejme obstoječe zaporedje in ga spremeni na podlagi besedilnih pozivov. To je video ekvivalent urejanja slik, vendar z strožjimi omejitvami formatov. Preden napišeš svojo prvo zahtevo, si zapomni štiri meje, ki določajo, kaj lahko pošlješ.
Končna točka POST /v1/videos/edits
Zahteva združi izvorni videoposnetek s pozivom, ki opisuje želeno spremembo.
{
"model": "grok-imagine-video",
"prompt": "Spremeni ozadje v sončni zahod nad oceanom",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Dovolj so tri polja: model, ki ostane grok-imagine-video; prompt, ki vsebuje opis spremembe; in video.url, ki kaže na datoteko MP4 za obdelavo. Opazi, da je videoposnetek zapakiran v predmet video, ki sprejme url ali file_id naložene datoteke: končna točka za razširjanje, o kateri bo govora v naslednji lekciji, uporablja isto konvencijo.
Tehnične omejitve so tu strožje kot pri ustvarjanju. Izvor ne sme presegati 8,7 sekunde, proizvedeni videoposnetek pa ohrani svoje trajanje; stran Video Generation omenja trajanje, „omejeno na 8,7 sekunde”, ne podrobneje pa ne opisuje ravnanja z daljšim virom: zato svoje vire vnaprej obreži. Ločljivost je omejena na 720p. Vhodna datoteka mora biti MP4 v podprtem kodeku, kot so H.264, H.265 ali AV1. Najbolj zmedeno za tiste, ki prihajajo iz ustvarjanja: nad trajanjem, razmerjem stranic ali ločljivostjo izhoda nimaš nobenega nadzora, vse to določa izvorni videoposnetek. Zahteva za urejanje ne vključuje polj duration, aspect_ratio ali resolution.
Kaj zahtevati pri urejanju
Zamenjava ozadja je klasičen primer: subjekt ostane, okolica se spremeni.
{
"model": "grok-imagine-video",
"prompt": "Zamenjaj ozadje s pokrajino vesolja z zvezdami in meglicami. Ohrani isti subjekt in isto gibanje.",
"video": {"url": "https://example.com/video.mp4"}
}
Spremembe sloga vplivajo na celotno sliko in preoblikujejo slog posnetka, ne da bi spremenile njegovo dejanje – praktično za prilagajanje istega zaporedja različnim univerzumom.
{
"model": "grok-imagine-video",
"prompt": "Preoblikuj ta videoposnetek v slog japonske risanke z živahnimi barvami",
"video": {"url": "https://example.com/video.mp4"}
}
Dodajanje elementov obogati prizor s plastmi, ki med snemanjem niso obstajale, običajno atmosferskimi.
{
"model": "grok-imagine-video",
"prompt": "Dodaj padajoč sneg in učinek zmrzali na robovih",
"video": {"url": "https://example.com/video.mp4"}
}
Končno, sprememba osvetlitve pomeni ponovno barvno korekcijo zaporedja: isti posnetki, radikalno drugačna atmosfera.
{
"model": "grok-imagine-video",
"prompt": "Spremeni osvetlitev v nočno vzdušje z modrimi in vijoličnimi neonskimi lučmi",
"video": {"url": "https://example.com/video.mp4"}
}
Asinhroni cikel, enak kot pri ustvarjanju
Urejanje sledi popolnoma enakemu štiristopenjskemu protokolu kot ustvarjanje: pošlješ zahtevo, prejmeš request_id, redno preverjaš stanje z GET /v1/videos/{request_id} in preneseš urejen videoposnetek, ko se stanje spremeni v done. V Pythonu prva dva koraka zavzameta le nekaj vrstic.
import httpx
# 1. Pošlji zahtevo za urejanje
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Dodaj učinek dežja čez celoten prizor",
"video": {"url": "https://example.com/source.mp4"}
}
)
request_id = response.json()["request_id"]
# 2. Preveri stanje (poenostavljeno)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Navedi, kaj se spremeni in kaj ostane
xAI obnašanje modela opiše v enem stavku: grok-imagine-video uporabi zahtevano spremembo in vse ostalo ohrani čim bližje izvoru. Njegova dokumentacija iz tega izpelje smernico: navedi tudi, kaj mora ostati enako. Njeni lastni primeri se prav tako osredotočajo na natančna urejanja enega samega posnetka – dodajanje srebrne ogrlice, sprememba obleke v rdečo, postavitev črnega klobuka s širokimi krajci na lika – ki tečejo vzporedno na istem izvoru.
{
"model": "grok-imagine-video",
"prompt": "Spremeni žensko jakno v rdečo. Ohrani isti obraz, isto okolico, isto kadrovanje in isto gibanje.",
"video": {"url": "https://example.com/video.mp4"}
}
Vodnik za pozive slik xAI, napisan za mirujoče slike, določa vrstni red, ki deluje: najprej sprememba, nato stavek, ki zaklene tisto, kar ostaja statično. Urejanje, ki se začne z „ohrani vse”, skoraj ničesar ne spremeni, urejanje, ki kopira celoten poziv za ustvarjanje, pa prizor na novo izumi.
Štiri navade se izognejo večini pastem: svoje vire ohrani pod 8,7 sekunde v podprtem kodeku (H.264, H.265 ali AV1); poimenuj, kar mora ostati nedotaknjeno; preizkusi spremembo na kratkem posnetku, preden jo razširiš; in zapomni si, da urejanje uporablja grok-imagine-video, katerega cenik prikazuje enotno stopnjo, 0,050 $ na sekundo – krog preizkusov stane enako kot ustvarjanje.
Ključne ugotovitve
- Končna točka
POST /v1/videos/editsspremeni obstoječi videoposnetek na podlagi poziva, in sicer izključno zgrok-imagine-video - Izvor traja največ 8,7 sekunde; izhod ohrani svoje trajanje, razmerje in ločljivost (največ 720p)
- Izvorni videoposnetek mora biti MP4 v podprtem kodeku (H.264, H.265, AV1)
- Zahteva nima polj
duration,aspect_ratioaliresolution - Navedi, kaj se mora spremeniti, nato kaj mora ostati enako