Videouitbreiding met /v1/videos/extensions
Op deze pagina
Les bijgewerkt op 2 november 2026 op basis van de xAI Video API-referentie: de uitbreiding ontvangt de video in een
video-object ({"url": ...}), precies zoals bij bewerken—de vorige tekst beweerde het tegenovergestelde—het resultaat wordt gelezen uitvideo.url, en de bron is beperkt tot 15 seconden. Bronnen: Video Extension · Video Reference.
Een bestaande video uitbreiden
Waar bewerken een sequentie transformeert zonder de lengte te wijzigen, doet uitbreiden precies het tegenovergestelde: het verlengt een video door een vervolg te genereren dat consistent is met wat eraan voorafging. Dit lost het meest voorkomende probleem bij videogeneratie op: een geslaagde clip die te kort is, of een scène die zich verder moet ontwikkelen dan de initiële duur. In plaats van alles opnieuw te genereren en te hopen dezelfde look te recreëren, begint u bij wat er al is en gaat u verder.
Het POST /v1/videos/extensions-eindpunt
Het verzoek lijkt op een generatieverzoek, met de toevoeging van de startvideo.
{
"model": "grok-imagine-video",
"prompt": "Continue the scene with a zoom out revealing the full landscape",
"video": {"url": "https://exemple.com/video-courte.mp4"},
"duration": 5
}
Het veld model blijft grok-imagine-video, prompt beschrijft wat er in het vervolg moet gebeuren, het video-object specificeert de uit te breiden video (een url of de file_id van een geüpload bestand, voor een bron van 2 tot 15 seconden), en duration stelt de lengte van de uitbreiding in tussen 2 en 10 seconden—de standaardwaarde is 6 seconden. In tegenstelling tot bewerken, krijgt u hier weer controle over de duur. De geretourneerde video bevat het origineel gevolgd door de uitbreiding: een bron van 10 seconden die met 5 seconden wordt uitgebreid, levert een video van 15 seconden op.
De volgende tabel vat samen wat de twee eindpunten onderscheidt, aangezien verwarring vaak voorkomt.
| Aspect | Bewerken (/edits) | Uitbreiden (/extensions) |
|---|---|---|
| Doelstelling | Inhoud wijzigen | Duur toevoegen |
| Videoparameter | video-object (url of file_id) | video-object (url of file_id) |
| Brond duur | Max. 8,7 s | 2 tot 15 s |
| Uitvoerduur | Gelijk aan bron (Max. 720p) | Bron + 2 tot 10 s |
| Originele inhoud | Wijzigt | Behoudt |
Beide REST API-eindpunten ontvangen de video op dezelfde manier: in een video-object met een url-eigenschap. De Python SDK neemt dit echter als de parameter video_url: kopieer deze parameternaam niet naar een JSON-body, de API zal deze niet herkennen. Wat de twee eindpunten echt onderscheidt, is de duur.
Drie manieren om een scène voort te zetten
Het eenvoudigste geval bestaat erin hetgeen al gebeurt gewoon te laten doorgaan. De prompt pikt de huidige actie op en breidt deze uit zonder onderbreking.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
U kunt ook een verandering introduceren, wat betekent dat u een nieuw element binnenbrengt of de kijkrichting wijzigt. Dit geeft een sequentie zijn narratieve voortgang.
{
"model": "grok-imagine-video",
"prompt": "The camera pivots right revealing a lighthouse in the distance, the lighthouse beam starts to rotate",
"video": {"url": "https://exemple.com/plage.mp4"},
"duration": 8
}
Het derde gebruiksscenario is de conclusie: een korte uitbreiding die de sequentie netjes afsluit, vaak met een vervaging.
{
"model": "grok-imagine-video",
"prompt": "The scene ends with a gradual fade to black, the last glimmers of sunlight disappear on the horizon",
"video": {"url": "https://exemple.com/coucher-soleil.mp4"},
"duration": 4
}
Uitbreidingen koppelen om een sequentie op te bouwen
Niets verhindert dat u een video meerdere keren achter elkaar uitbreidt. Elke uitbreiding produceert een nieuwe video waarvan de URL kan dienen als bron voor de volgende uitbreiding, zodat u via opeenvolgende segmenten een lange sequentie kunt opbouwen, elk aangestuurd door zijn eigen prompt. Het onderstaande script koppelt drie uitbreidingen door de verkregen URL bij elke stap opnieuw in te voeren.
import httpx
import time
api_key = "your_key"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
def attendre_video(request_id):
"""Poll status until completion."""
while True:
resp = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers=headers
).json()
if resp["status"] == "done":
return resp["video"]["url"]
if resp["status"] == "failed":
raise RuntimeError(f"Generation failed: {resp.get('error')}")
time.sleep(5)
# Base video
video_url = "https://exemple.com/video-initiale.mp4"
# Chain 3 extensions
prompts = [
"The character crosses the bridge, profile view",
"He stops in the middle and looks at the river below",
"He resumes walking toward the other bank, the camera follows"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/extensions",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"video": {"url": video_url},
"duration": 5
}
).json()
video_url = attendre_video(resp["request_id"])
print(f"Extension complete: {video_url}")
Deze elegantie heeft een prijs, letterlijk en figuurlijk. Elke uitbreiding wordt apart gefactureerd. De bron mag niet langer zijn dan 15 seconden, wat de keten begrenst: beginnend vanaf 5 seconden, bereikt de sequentie na drie uitbreidingen van 5 seconden een duur van 20 seconden, en een vierde zou worden geweigerd. De visuele coherentie verslechtert over de schakels heen, aangezien elke stap vertrouwt op een reeds geïnterpreteerde uitvoer: voorbij drie of vier gekoppelde uitbreidingen worden kleur- en morfologie-afwijkingen zichtbaar. En zoals overal in deze API, zijn URLs tijdelijk—download elke tussenversie, anders dwingt een fout aan het einde van de keten u om helemaal opnieuw te beginnen.
Het duo generatie en vervolgens uitbreiding
Het meest voorkomende patroon in productie combineert beide eindpunten. U genereert eerst een korte basis van 3 seconden met een zeer precieze prompt, via POST /v1/videos/generations, waardoor u tegen lagere kosten kunt itereren op de startesthetiek. Vervolgens voegt u 5 seconden ontwikkeling toe via POST /v1/videos/extensions, en daarna 4 seconden conclusie via een tweede oproep naar hetzelfde eindpunt. Het resultaat is een video van 12 seconden, segment voor segment opgebouwd, waarbij elk deel werd gevalideerd voordat het volgende werd gestart—een controle die geen enkele generatie van 12 seconden in één keer zou bieden.
Belangrijkste punten
- Uitbreiding verlengt een video van 2 tot 15 seconden met een segment van 2 tot 10 seconden (standaard 6), en retourneert de complete video
- De bronvideo gaat in een
video-object (urloffile_id), net als bij bewerken; de Python SDK neemt dit alsvideo_url - Koppelen maakt het mogelijk om lange sequenties stap voor stap te creëren
- Coherentie verslechtert na 3 tot 4 opeenvolgende uitbreidingen
- Combineer initiële generatie + uitbreidingen voor precieze inhoudscontrole