Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Urejanje videoposnetkov z /v1/videos/edits

Lekcija 7 od 12 Posodobljeno 3. november 2026 Srednje napredni
Na tej strani
  1. Urejanje obstoječega videoposnetka
  2. Končna točka POST /v1/videos/edits
  3. Kaj zahtevati pri urejanju
  4. Asinhroni cikel, enak kot pri ustvarjanju
  5. Navedi, kaj se spremeni in kaj ostane
  6. Ključne ugotovitve

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 video kot 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š.

8,7 s
Najdaljše trajanje vira
720p
Največja ločljivost
H.265
Sprejeti kodek (npr. H.264, AV1)
MP4
Zahtevana oblika

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()

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/edits spremeni obstoječi videoposnetek na podlagi poziva, in sicer izključno z grok-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_ratio ali resolution
  • Navedi, kaj se mora spremeniti, nato kaj mora ostati enako