Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Videobewerking met /v1/videos/edits

Les 7 van 12 Bijgewerkt op 3 november 2026 Gemiddeld
Op deze pagina
  1. Een bestaande video bewerken
  2. Het POST /v1/videos/edits-eindpunt
  3. Wat u kunt vragen in een bewerking
  4. De asynchrone cyclus, identiek aan generatie
  5. Specificeer wat verandert en wat gelijk blijft
  6. Belangrijkste punten

Bijgewerkt op 3 november 2026. Gebaseerd op de pagina Video Editing van xAI: de bronvideo is maximaal 8,7 seconden lang, de uitvoer behoudt de duur, beeldverhouding en resolutie (maximaal 720p), en uitbreiding gebruikt hetzelfde video-object als bewerking. De eerdere bewering dat bewerking onbetrouwbaar was voor specifieke elementen, spreekt de voorbeelden van xAI tegen, die zich juist richten op nauwkeurige edits. Bronnen: Video Editing · Video Overview.

Een bestaande video bewerken

Generatie is slechts een deel van het werk. De xAI-API biedt ook een eindpunt voor videobewerking dat een bestaande reeks accepteert en deze wijzigt op basis van tekstprompts. Het is het video-equivalent van beeldbewerking, maar met strengere formaatbeperkingen. Voordat u uw eerste verzoek schrijft, moet u rekening houden met de vier grenswaarden die bepalen wat u kunt indienen.

8,7 s
Maximale brond duur
720p
Maximale resolutie
H.265
Geaccepteerde codec (zoals H.264, AV1)
MP4
Vereist formaat

Het POST /v1/videos/edits-eindpunt

Het verzoek koppelt een bronvideo aan een prompt die de gewenste wijziging beschrijft.

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

Drie velden volstaan: model, dat grok-imagine-video blijft; prompt, dat de beschrijving van de wijziging bevat; en video.url, dat verwijst naar het te verwerken MP4-bestand. Merk op dat de video is ingekapseld in een video-object, dat een url of de file_id van een geüpload bestand accepteert: het uitbreidingseindpunt, in de volgende les, hanteert dezelfde conventie.

De technische beperkingen zijn hier strenger dan bij generatie. De bron mag niet langer zijn dan 8,7 seconden en de geproduceerde video behoudt deze duur; de pagina Video Generation noemt een duur die “beperkt is tot 8,7 seconden” zonder details te geven over de afhandeling van een langere bron: knip uw bronnen daarom vooraf bij. De resolutie is beperkt tot 720p. Het invoerbestand moet een MP4 zijn in een ondersteunde codec, zoals H.264, H.265 of AV1. Het meest verwarrende punt voor wie komt vanuit generatie: u heeft geen controle over de duur, beeldverhouding of resolutie van de uitvoer; deze worden allemaal bepaald door de bronvideo. Het bewerkingsverzoek bevat geen veld duration, aspect_ratio of resolution.

Wat u kunt vragen in een bewerking

Achtergrondvervanging is het schoolvoorbeeld: het onderwerp blijft, de omgeving verandert.

{
  "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"}
}

Stijlwijzigingen beïnvloeden het hele beeld en transformeren de stijl van de clip zonder de actie te wijzigen—praktisch om dezelfde reeks aan te passen aan verschillende universums.

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

Het toevoegen van elementen verrijkt de scène met lagen die tijdens het filmen niet bestonden, meestal atmosferisch van aard.

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

Tot slot komt belichtingswijziging neer op het hergraderen van de reeks: dezelfde opnamen, maar een radicaal andere sfeer.

{
  "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"}
}

De asynchrone cyclus, identiek aan generatie

Bewerking volgt exact hetzelfde vierstappenprotocol als generatie: u verzendt het verzoek, ontvangt een request_id, peilt regelmatig GET /v1/videos/{request_id} en haalt de bewerkte video op wanneer de status verandert in done. In Python passen de eerste twee stappen in een paar regels code.

import httpx

# 1. De bewerking indienen
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. De status peilen (vereenvoudigd)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Specificeer wat verandert en wat gelijk blijft

xAI beschrijft het gedrag van het model in één zin: grok-imagine-video past de gevraagde wijziging toe en houdt alles andere zo dicht mogelijk bij de bron. De documentatie leidt hieruit een richtlijn af: geef ook aan wat identiek moet blijven. De eigen voorbeelden richten zich ook op nauwkeurige edits van één clip—het toevoegen van een zilveren ketting, het veranderen van een outfit in rood, het plaatsen van een zwarte breedgerande hoed op een personage—die parallel worden uitgevoerd op dezelfde bron.

{
  "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"}
}

De gids voor beeldprompts van xAI, geschreven voor stilstaande beelden, specificeert de volgorde die werkt: eerst de wijziging, daarna een zin die vastlegt wat statisch blijft. Een bewerking die begint met “houd alles gelijk”, verandert bijna niets, en een bewerking die een volledige generatieprompt kopieert, vindt de scène opnieuw uit.

Vier gewoonten voorkomen de meeste valkuilen: houd uw bronnen onder de 8,7 seconden in een ondersteunde codec (H.264, H.265 of AV1); benoem wat intact moet blijven; test een wijziging op een korte clip voordat u deze opschalt; en onthoud dat bewerking grok-imagine-video gebruikt, waarvan de prijstabel één tarief toont, $0,050 per seconde—een reeks proeven kost evenveel als generatie.

Belangrijkste punten

  • Het eindpunt POST /v1/videos/edits wijzigt een bestaande video op basis van een prompt, uitsluitend met grok-imagine-video
  • De bron duurt maximaal 8,7 seconden; de uitvoer behoudt de duur, verhouding en resolutie (maximaal 720p)
  • De bronvideo moet een MP4 zijn in een ondersteunde codec (H.264, H.265, AV1)
  • Het verzoek bevat geen veld duration, aspect_ratio of resolution
  • Geef aan wat moet veranderen en vervolgens wat identiek moet blijven