Redigering af videoer med /v1/videos/edits
På denne side
Opdateret 3. november 2026. Baseret på xAI’s side om Video Editing: Kildevideoen må højst være 8,7 sekunder lang, outputtet beholder sin varighed, sit formatforhold og sin opløsning (maks. 720p), og udvidelse bruger det samme
video-objekt som redigering. Den tidligere påstand om, at redigering var upålidelig for specifikke elementer, modsiger xAI’s eksempler, der netop fokuserer på præcise redigeringer. Kilder: Video Editing · Video Overview.
Rediger en eksisterende video
Generering er kun en del af arbejdet. xAI API’et eksponerer også et endpoint til videoredigering, der tager en eksisterende sekvens og modificerer den baseret på tekstprompt. Det er videoens svar på billedredigering, men med strengere formatbegrænsninger. Før du skriver din første anmodning, skal du bemærke de fire grænser, der afgør, hvad du kan indsende.
POST /v1/videos/edits-endpointet
Anmodningen parer en kildevideo med en prompt, der beskriver den ønskede modificering.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Tre felter er nok: model, som forbliver grok-imagine-video; prompt, som indeholder beskrivelsen af modificeringen; og video.url, som peger på MP4-filen, der skal behandles. Bemærk, at videoen er kapslet i et video-objekt, der accepterer enten en url eller file_id for en uploadet fil: udvidelses-endpointet, som vi ser på i næste lektion, følger samme konvention.
De tekniske begrænsninger er strengere her end ved generering. Kilden må ikke overstige 8,7 sekunder, og den producerede video beholder sin varighed; siden Video Generation nævner en varighed „begrænset til 8,7 sekunder” uden at detaljere håndteringen af en længere kilde: så beskær dine kilder på forhånd. Opløsningen er begrænset til 720p. Inputfilen skal være en MP4 i en understøttet codec, f.eks. H.264, H.265 eller AV1. Det mest forvirrende punkt for dem, der kommer fra generering: Du har ingen kontrol over varighed, formatforhold eller opløsning i outputtet; alt bestemmes af kildevideoen. Redigeringsanmodningen indeholder intet felt for duration, aspect_ratio eller resolution.
Hvad du skal bede om i en redigering
Udskiftning af baggrund er skoleeksemplet: motivet forbliver, mens omgivelserne ændres.
{
"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"}
}
Stilændringer påvirker hele billedet og transformerer klippets stil uden at modificere handlingen – praktisk til at tilpasse samme sekvens til forskellige universer.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
Tilføjelse af elementer beriger scenen med lag, der ikke eksisterede under optagelsen, typisk atmosfæriske effekter.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Endelig svarer modificering af belysning til en ny farvegrading af sekvensen: samme optagelser, radikalt anderledes stemning.
{
"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"}
}
Den asynkrone cyklus, identisk med generering
Redigering følger nøjagtig samme firetrinsprotokol som generering: Du sender anmodningen, modtager en request_id, spørger GET /v1/videos/{request_id} med jævne mellemrum, og henter den redigerede video, når status ændres til done. I Python passer de to første trin på få linjer.
import httpx
# 1. Indsend redigeringen
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. Poll status (forenklet)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Angiv hvad der ændres, og hvad der forbliver
xAI beskriver modellens adfærd i én sætning: grok-imagine-video anvender den anmodede ændring og holder alt andet så tæt på kilden som muligt. Deres dokumentation udleder en retningslinje heraf: Sig også, hvad der skal forblive identisk. Deres egne eksempler fokuserer også på præcise redigeringer af et enkelt klip – tilføjelse af en sølvhalskæde, ændring af et outfit til rødt, placering af en sort bredskygget hat på en karakter – kørt parallelt på samme kilde.
{
"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"}
}
xAI’s guide til billedprompt, skrevet til stillbilleder, specificerer den rækkefølge, der virker: modificeringen først, derefter en sætning, der låser det, der forbliver statisk. En redigering, der starter med „behold alt”, ændrer næsten ingenting, og en redigering, der kopierer en fuld genereringsprompt, genopfinder scenen.
Fire vaner undgår de fleste faldgruber: Hold dine kilder under 8,7 sekunder i en understøttet codec (H.264, H.265 eller AV1); navngiv hvad der skal forblive intakt; test en modificering på et kort klip, før du skalere det op; og husk, at redigering bruger grok-imagine-video, hvis prisliste viser én enkelt sats, $0,050 per sekund – en række forsøg koster det samme som generering.
Vigtige pointer
- Endpointet
POST /v1/videos/editsmodificerer en eksisterende video baseret på en prompt, kun medgrok-imagine-video - Kilden varer højst 8,7 sekunder; outputtet beholder sin varighed, sit forhold og sin opløsning (maks. 720p)
- Kildevideoen skal være en MP4 i en understøttet codec (H.264, H.265, AV1)
- Anmodningen har intet felt for
duration,aspect_ratioellerresolution - Angiv hvad der skal ændres, og derefter hvad der skal forblive identisk