Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Redigering av video med /v1/videos/edits

Lektion 7 av 12 Uppdaterad 3 november 2026 Medelnivå
På denna sida
  1. Redigera en befintlig video
  2. Slutpunkten POST /v1/videos/edits
  3. Vad du ska be om i en redigering
  4. Den asynkrona cykeln, identisk med generering
  5. Specificera vad som ändras och vad som stannar
  6. Viktiga punkter

Uppdaterat den 3 november 2026. Baserat på xAI:s sida Video Editing: källvideon är högst 8,7 sekunder lång, utdata behåller sin längd, sitt bildförhållande och sin upplösning (max 720p), och förlängning använder samma video-objekt som redigering. Det tidigare påståendet att redigering var opålitlig för specifika element motsägs av xAI:s exempel, som fokuserar just på precisa ändringar. Källor: Video Editing · Video Overview.

Redigera en befintlig video

Generering är bara en del av jobbet. xAI:s API erbjuder också en slutpunkt för videoredigering som tar en befintlig sekvens och modifierar den baserat på textprompter. Det är videons motsvarighet till bildredigering, men med striktare formatbegränsningar. Innan du skriver din första begäran bör du känna till de fyra gränser som avgör vad du kan skicka in.

8,7 s
Maximal källängd
720p
Maximal upplösning
H.265
Accepterad codec (t.ex. H.264, AV1)
MP4
Obligatoriskt format

Slutpunkten POST /v1/videos/edits

Begäran parar ihop en källvideo med en prompt som beskriver den önskade modifieringen.

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

Tre fält räcker: model, som förblir grok-imagine-video; prompt, som innehåller beskrivningen av modifieringen; och video.url, som pekar på MP4-filen som ska bearbetas. Lägg märke till att videon kapslas in i ett video-objekt, som accepterar antingen en url eller file_id för en uppladdad fil: slutpunkten för förlängning, i nästa lektion, följer samma konvention.

De tekniska begränsningarna är striktare här än vid generering. Källan får inte överstiga 8,7 sekunder, och den producerade videon behåller sin längd; sidan Video Generation nämner en längd som är “begränsad till 8,7 sekunder” utan att detaljera hanteringen av en längre källa: så klipp dina källor i förväg. Upplösningen är begränsad till 720p. Indatafilen måste vara en MP4 i en codec som stöds, till exempel H.264, H.265 eller AV1. Den mest förvirrande punkten för dig som kommer från generering: du har ingen kontroll över längd, bildförhållande eller upplösning i utdata; allt detta bestäms av källvideon. Redigeringsbegäran innehåller inget fält för duration, aspect_ratio eller resolution.

Vad du ska be om i en redigering

Byte av bakgrund är skolboksexemplet: motivet stannar kvar, men miljön ändras.

{
  "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ändringar påverkar hela bilden och transformerar klippets stil utan att modifiera dess action – praktiskt för att anpassa samma sekvens till olika universum.

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

Att lägga till element berikar scenen med lager som inte fanns under inspelningen, vanligtvis atmosfäriska sådana.

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

Slutligen innebär modifiering av belysning att sekvensen färgkorrigeras: samma tagningar, men en radikalt annan stämning.

{
  "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 asynkrona cykeln, identisk med generering

Redigering följer exakt samma fyrastegsprotokoll som generering: du skickar begäran, du får ett request_id, du frågar GET /v1/videos/{request_id} med jämna mellanrum, och du hämtar den redigerade videon när statusen ändras till done. I Python ryms de två första stegen på några få rader.

import httpx

# 1. Skicka in 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. Fråga efter status (förenklat)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Specificera vad som ändras och vad som stannar

xAI beskriver modellens beteende i en mening: grok-imagine-video tillämpar den begärda ändringen och behåller allt annat så nära källan som möjligt. Deras dokumentation härleder en riktlinje från detta: säg också vad som måste förbli identiskt. Deras egna exempel fokuserar också på precisa redigeringar av ett enda klipp – att lägga till ett silverhalsband, byta ett outfit till rött, eller sätta en svart bredbrättad hatt på en karaktär – som körs parallellt på samma källa.

{
  "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 för bildprompter, skriven för stillbilder, specificerar den ordning som fungerar: modifieringen först, sedan en mening som låser fast vad som ska vara statiskt. En redigering som börjar med “behåll allt” ändrar nästan ingenting, och en redigering som kopierar en hel genereringsprompt återskapar scenen från grunden.

Fyra vanor undviker de flesta fallgropar: håll dina källor under 8,7 sekunder i en codec som stöds (H.264, H.265 eller AV1); namnge vad som måste förbli intakt; testa en modifiering på ett kort klipp innan du skalar upp det; och kom ihåg att redigering använder grok-imagine-video, vars prislista visar en enda taxa, 0,050 USD per sekund – en omgång tester kostar lika mycket som generering.

Viktiga punkter

  • Slutpunkten POST /v1/videos/edits modifierar en befintlig video baserat på en prompt, endast med grok-imagine-video
  • Källan varar högst 8,7 sekunder; utdata behåller sin längd, sitt bildförhållande och sin upplösning (max 720p)
  • Källvideon måste vara en MP4 i en codec som stöds (H.264, H.265, AV1)
  • Begäran har inget fält för duration, aspect_ratio eller resolution
  • Ange vad som ska ändras, och sedan vad som måste förbli identiskt