Video-Erweiterung mit /v1/videos/extensions
Auf dieser Seite
Lektion aktualisiert am 2. November 2026 basierend auf der xAI Video-API-Referenz: Die Erweiterung erhält das Video in einem
video-Objekt ({"url": ...}), genau wie beim Bearbeiten – die vorherige Textfassung behauptete das Gegenteil – das Ergebnis wird ausvideo.urlgelesen, und die Quelle ist auf 15 Sekunden begrenzt. Quellen: Video-Erweiterung · Video-Referenz.
Erweiterung eines bestehenden Videos
Während das Bearbeiten eine Sequenz verändert, ohne ihre Länge zu ändern, tut die Erweiterung genau das Gegenteil: Sie verlängert ein Video, indem sie eine Fortsetzung generiert, die konsistent zu dem ist, was zuvor kam. Dies löst das häufigste Problem bei der Videogenerierung: ein erfolgreicher Clip, der zu kurz ist, oder eine Szene, die sich über ihre anfängliche Dauer hinaus entwickeln sollte. Anstatt alles neu zu generieren und zu hoffen, dass sich derselbe Look wiederholt, beginnen Sie mit dem, was bereits existiert, und setzen es fort.
Der POST /v1/videos/extensions-Endpunkt
Die Anfrage ähnelt einer Generierungsanfrage, wobei das Startvideo hinzugefügt wird.
{
"model": "grok-imagine-video",
"prompt": "Setze die Szene fort mit einem Zoom heraus, der die gesamte Landschaft enthüllt",
"video": {"url": "https://exemple.com/video-courte.mp4"},
"duration": 5
}
Das Feld model bleibt grok-imagine-video, der prompt beschreibt, was in der Fortsetzung geschehen soll, das video-Objekt gibt das zu erweiternde Video an (eine url oder die file_id eines hochgeladenen Datei, für eine Quelle von 2 bis 15 Sekunden), und duration legt die Erweiterungslänge zwischen 2 und 10 Sekunden fest – der Standardwert beträgt 6 Sekunden. Im Gegensatz zum Bearbeiten haben Sie hier die Kontrolle über die Dauer zurück. Das zurückgegebene Video enthält das Original gefolgt von der Erweiterung: Eine 10-Sekunden-Quelle, die um 5 Sekunden erweitert wird, ergibt ein 15-Sekunden-Video.
Die folgende Tabelle fasst zusammen, was die beiden Endpunkte unterscheidet, da Verwechslungen häufig sind.
| Aspekt | Bearbeiten (/edits) | Erweiterung (/extensions) |
|---|---|---|
| Ziel | Inhalt ändern | Dauer hinzufügen |
| Video-Parameter | video-Objekt (url oder file_id) | video-Objekt (url oder file_id) |
| Quellendauer | Max. 8,7 s | 2 bis 15 s |
| Ausgabendauer | Gleiche wie Quelle (Max. 720p) | Quelle + 2 bis 10 s |
| Originalinhalt | Wird verändert | Wird erhalten |
Beide REST-API-Endpunkte erhalten das Video auf dieselbe Weise, in einem video-Objekt mit einer url-Eigenschaft. Das Python-SDK nimmt es jedoch als Parameter video_url entgegen: Kopieren Sie diesen Parameter-Namen nicht in einen JSON-Körper, die API erkennt ihn nicht. Was die beiden Endpunkte wirklich unterscheidet, ist die Dauer.
Drei Möglichkeiten, eine Szene fortzusetzen
Der einfachste Fall besteht darin, das bereits Geschehende einfach fortsetzen zu lassen. Der Prompt greift die aktuelle Handlung auf und verlängert sie ohne Unterbrechung.
{
"model": "grok-imagine-video",
"prompt": "Die Figur setzt fort, entlang des Strandes zu gehen, die Wellen rollen sanft",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Sie können auch eine Veränderung einführen, was bedeutet, ein neues Element hinzuzufügen oder die Blickrichtung zu ändern. Dies verleiht einer Sequenz ihre narrative Fortschreitung.
{
"model": "grok-imagine-video",
"prompt": "Die Kamera dreht sich nach rechts und enthüllt ein Leuchtturms in der Ferne, der Strahl des Leuchtturms beginnt sich zu drehen",
"video": {"url": "https://exemple.com/plage.mp4"},
"duration": 8
}
Dritter Anwendungsfall: Das Ende. Eine kurze Erweiterung, die die Sequenz sauber abschließt, oft mit einem Ausblenden.
{
"model": "grok-imagine-video",
"prompt": "Die Szene endet mit einem allmählichen Ausblenden ins Schwarz, die letzten Funken Sonnenlicht verschwinden am Horizont",
"video": {"url": "https://exemple.com/coucher-soleil.mp4"},
"duration": 4
}
Verkettung von Erweiterungen zur Erstellung einer Sequenz
Es ist nichts dagegen, ein Video mehrfach hintereinander zu erweitern. Jede Erweiterung erzeugt ein neues Video, dessen URL als Quelle für die nächste Erweiterung dienen kann, sodass Sie eine lange Sequenz über aufeinanderfolgende Segmente aufbauen können, wobei jedes Segment durch seinen eigenen Prompt gesteuert wird. Der folgende Skript verkettet drei Erweiterungen, indem er die erhaltene URL in jedem Schritt wieder einsetzt.
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)
# Basisvideo
video_url = "https://exemple.com/video-initiale.mp4"
# Verkettung von 3 Erweiterungen
prompts = [
"Die Figur überquert die Brücke, Profilansicht",
"Er hält in der Mitte an und schaut auf den Fluss unten",
"Er setzt fort, zum anderen Ufer zu gehen, die Kamera folgt"
]
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"Erweiterung abgeschlossen: {video_url}")
Diese Eleganz hat einen Preis, wörtlich und bildlich. Jede Erweiterung wird separat abgerechnet. Die Quelle darf 15 Sekunden nicht überschreiten, was die Kette begrenzt: Beginnen Sie mit 5 Sekunden, erreicht die Sequenz nach drei 5-Sekunden-Erweiterungen 20 Sekunden, und eine vierte würde abgelehnt. Die visuelle Kohärenz verschlechtert sich über die Verbindungen hinweg, da jeder Schritt auf einer bereits interpretierten Ausgabe basiert: Jenseits von drei oder vier verketteten Erweiterungen werden Farb- und Morphologie-Drifts sichtbar. Und wie überall in dieser API sind URLs vorübergehend – laden Sie jede Zwischenversion herunter, sonst zwingt ein Fehler am Ende der Kette Sie dazu, von vorne zu beginnen.
Das Duo Generierung und Erweiterung
Das häufigste Muster in der Produktion kombiniert beide Endpunkte. Sie generieren zunächst eine kurze 3-Sekunden-Basis mit einem sehr präzisen Prompt über POST /v1/videos/generations, was Ihnen erlaubt, die anfängliche Ästhetik zu einem geringeren Kosten zu iterieren. Sie fügen dann 5 Sekunden Entwicklung über POST /v1/videos/extensions hinzu, gefolgt von 4 Sekunden Schlussfolgerung über einen zweiten Aufruf desselben Endpunkts. Das Ergebnis ist ein 12-Sekunden-Video, das segmentweise aufgebaut wurde, wobei jeder Teil validiert wurde, bevor der nächste in Angriff genommen wurde – eine Kontrolle, die eine einzelne 12-Sekunden-Generierung nicht bieten würde.
Wichtige Punkte zur Erinnerung
- Die Erweiterung verlängert ein 2 bis 15 Sekunden langes Video um ein Segment von 2 bis 10 Sekunden (Standard 6) und gibt das vollständige Video zurück
- Das Quellvideo geht in ein
video-Objekt (urloderfile_id), wie beim Bearbeiten; das Python-SDK nimmt es alsvideo_urlentgegen - Verkettung ermöglicht das schrittweise Erstellen langer Sequenzen
- Kohärenz verschlechtert sich jenseits von 3-4 aufeinanderfolgenden Erweiterungen
- Kombinieren Sie initiale Generierung und Erweiterungen für präzise Inhaltskontrolle