Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Video-Editing mit /v1/videos/edits

Lektion 7 von 12 Aktualisiert am 3. November 2026 Mittelstufe
Auf dieser Seite
  1. Eine bestehende Videoaufnahme bearbeiten
  2. Der POST /v1/videos/edits-Endpunkt
  3. Was Sie in einer Bearbeitung anfordern sollten
  4. Der asynchrone Zyklus, identisch zur Generierung
  5. Definieren Sie, was sich ändert, und was gleich bleibt
  6. Kernaussagen

Aktualisiert am 3. November 2026. Basierend auf der xAI-Seite Video Editing: Die Quelldauer beträgt maximal 8,7 Sekunden, die Ausgabe behält ihre Dauer, das Seitenverhältnis und die Auflösung bei (max. 720p), und die Erweiterung verwendet denselben video-Objekt-Typ wie das Editing. Die frühere Behauptung, dass das Editing für bestimmte Elemente unzuverlässig sei, widerspricht den Beispielen von xAI, die sich genau auf präzise Änderungen konzentrieren. Quellen: Video Editing · Video Overview.

Eine bestehende Videoaufnahme bearbeiten

Die Generierung ist nur ein Teil der Aufgabe. Die xAI-API stellt auch einen Endpunkt für das Video-Editing bereit, der eine bestehende Sequenz übernimmt und diese basierend auf Textanweisungen modifiziert. Es ist das Video-Äquivalent zum Bild-Editing, jedoch mit strengeren Formatbeschränkungen. Bevor Sie Ihre erste Anfrage verfassen, beachten Sie die vier Grenzen, die bestimmen, was Sie einreichen können.

8,7 s
Maximale Quelldauer
720p
Maximale Auflösung
H.265
Akzeptierter Codec (z. B. H.264, AV1)
MP4
Erforderliches Format

Der POST /v1/videos/edits-Endpunkt

Die Anfrage koppelt eine Quellvideoaufnahme mit einer Anweisung, die die gewünschte Modifikation beschreibt.

{
  "model": "grok-imagine-video",
  "prompt": "Ändern Sie den Hintergrund in einen Sonnenuntergang über dem Ozean",
  "video": {
    "url": "https://example.com/original-video.mp4"
  }
}

Drei Felder reichen aus: model, der weiterhin grok-imagine-video ist; prompt, der die Beschreibung der Modifikation enthält; und video.url, der auf die MP4-Datei verweist, die verarbeitet werden soll. Beachten Sie, dass das Video in einem video-Objekt verkapselt ist, das entweder eine url oder die file_id einer hochgeladenen Datei akzeptiert: Der Endpunkt für Erweiterungen in der nächsten Lektion übernimmt dieselbe Konvention.

Die technischen Anforderungen sind hier strenger als bei der Generierung. Die Quelle darf 8,7 Sekunden nicht überschreiten, und das erzeugte Video behält seine Dauer bei; die Seite Video Generation erwähnt eine Dauer, die „auf 8,7 Sekunden begrenzt ist”, ohne die Handhabung einer längeren Quelle zu erläutern: Schneiden Sie Ihre Quellen daher vorab. Die Auflösung ist auf 720p begrenzt. Die Eingabe-Datei muss ein MP4 in einem unterstützten Codec sein, wie H.264, H.265 oder AV1. Der verwirrendste Punkt für diejenigen, die aus der Generierung kommen: Sie haben keine Kontrolle über die Dauer, das Seitenverhältnis oder die Auflösung der Ausgabe; diese werden vollständig durch das Quellvideo bestimmt. Die Edit-Anfrage enthält kein Feld für duration, aspect_ratio oder resolution.

Was Sie in einer Bearbeitung anfordern sollten

Der Hintergrundtausch ist der klassische Fall: Das Motiv bleibt erhalten, die Umgebung ändert sich.

{
  "model": "grok-imagine-video",
  "prompt": "Ersetzen Sie den Hintergrund durch eine Weltenlandschaft mit Sternen und Nebeln. Behalten Sie dasselbe Motiv und dieselbe Bewegung bei.",
  "video": {"url": "https://example.com/video.mp4"}
}

Stiländerungen betreffen das gesamte Bild und transformieren den Stil des Clips, ohne dessen Handlung zu verändern – praktisch, um dieselbe Sequenz in verschiedene Universen anzupassen.

{
  "model": "grok-imagine-video",
  "prompt": "Transformieren Sie dieses Video in einen japanischen Cartoon-Stil mit leuchtenden Farben",
  "video": {"url": "https://example.com/video.mp4"}
}

Das Hinzufügen von Elementen bereichert die Szene mit Schichten, die während der Aufnahme noch nicht existierten, meist atmosphärischer Natur.

{
  "model": "grok-imagine-video",
  "prompt": "Fügen Sie fallenden Schnee und einen Frost-Effekt an den Rändern hinzu",
  "video": {"url": "https://example.com/video.mp4"}
}

Schließlich entspricht die Lichtmodifikation einer Neuvertonung der Sequenz: dieselben Aufnahmen, aber eine radikal andere Stimmung.

{
  "model": "grok-imagine-video",
  "prompt": "Ändern Sie die Beleuchtung in eine nächtliche Atmosphäre mit blauen und lila Neonlichtern",
  "video": {"url": "https://example.com/video.mp4"}
}

Der asynchrone Zyklus, identisch zur Generierung

Das Editing folgt exakt dem gleichen vierstufigen Protokoll wie die Generierung: Sie senden die Anfrage, Sie erhalten eine request_id, Sie befragen GET /v1/videos/{request_id} in regelmäßigen Abständen und Sie rufen das bearbeitete Video ab, wenn der Status auf done wechselt. In Python passen die ersten beiden Schritte in wenigen Zeilen.

import httpx

# 1. Die Bearbeitung einreichen
response = httpx.post(
    "https://api.x.ai/v1/videos/edits",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "grok-imagine-video",
        "prompt": "Fügen Sie einen Regeneffekt über die gesamte Szene hinzu",
        "video": {"url": "https://example.com/source.mp4"}
    }
)
request_id = response.json()["request_id"]

# 2. Den Status abfragen (vereinfacht)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Definieren Sie, was sich ändert, und was gleich bleibt

xAI beschreibt das Modellverhalten in einem Satz: grok-imagine-video wendet die angeforderte Änderung an und hält alles andere so nah wie möglich an der Quelle. Seine Ableitung daraus lautet: Nennen Sie auch, was identisch bleiben muss. Die eigenen Beispiele konzentrieren sich ebenfalls auf präzise Änderungen an einem einzelnen Clip – das Hinzufügen einer silbernen Halskette, das Ändern eines Outfits zu Rot, das Aufsetzen einer schwarzen breiten Krempe auf eine Figur – die parallel auf derselben Quelle ausgeführt werden.

{
  "model": "grok-imagine-video",
  "prompt": "Ändern Sie die Jacke der Frau in Rot. Behalten Sie dasselbe Gesicht, dieselbe Umgebung, dasselbe Bildausschnitt und dieselbe Bewegung bei.",
  "video": {"url": "https://example.com/video.mp4"}
}

Der Leitfaden für Bildanweisungen von xAI, der für statische Bilder geschrieben wurde, gibt die Reihenfolge an, die funktioniert: zuerst die Modifikation, dann ein Satz, der festlegt, was statisch bleibt. Eine Bearbeitung, die mit „alles beibehalten” beginnt, ändert fast nichts, und eine Bearbeitung, die einen vollständigen Generierungs-Prompt kopiert, erfindet die Szene neu.

Vier Gewohnheiten vermeiden die meisten Fallstricke: Halten Sie Ihre Quellen unter 8,7 Sekunden, in einem unterstützten Codec (H.264, H.265 oder AV1); benennen Sie, was unverändert bleiben muss; testen Sie eine Modifikation an einem kurzen Clip, bevor Sie sie skalieren; und denken Sie daran, dass das Editing grok-imagine-video verwendet, dessen Preisgitter eine einzige Rate zeigt, 0,050 USD pro Sekunde – eine Runde Versuche kostet dasselbe wie eine Generierung.

Kernaussagen

  • Der Endpunkt POST /v1/videos/edits modifiziert ein bestehendes Video basierend auf einer Anweisung, wobei nur grok-imagine-video verwendet wird
  • Die Quelle dauert maximal 8,7 Sekunden; die Ausgabe behält ihre Dauer, ihr Verhältnis und ihre Auflösung bei (max. 720p)
  • Die Quellvideoaufnahme muss ein MP4 in einem unterstützten Codec sein (H.264, H.265, AV1)
  • Die Anfrage enthält kein Feld für duration, aspect_ratio oder resolution
  • Nennen Sie, was sich ändern muss, und dann, was identisch bleiben muss