Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um einen vorhandenen Quellclip mit Runways Video-zu-Video-Workflow zu transformieren. Er startet eine asynchrone Aufgabe, anstatt die endgültige Ausgabe sofort zurückzugeben.

Bevor Sie ihn aufrufen

  • Bereiten Sie ein Quellvideo vor, das den Eingabeanforderungen des Anbieters entspricht
  • Fügen Sie den erforderlichen Header X-Runway-Version für den gewünschten Funktionsumfang hinzu
  • Beginnen Sie mit einem kurzen Prompt, der die Änderung beschreibt, nicht mit einem vollständigen Storyboard

Ausgabeverhältnis

Dieser Endpunkt erwartet durch Doppelpunkte getrennte ratio-Werte. Verwenden Sie 1280:720 für eine Ausgabe in 1280x720 und 720:1280 für 720x1280; 1280x720 wird nicht auf jeder Runway-Video-zu-Video-Route akzeptiert.

Aufgabenablauf

1

Quellclip und Prompt übermitteln

Starten Sie die Aufgabe über diesen Endpunkt und speichern Sie die zurückgegebene task id.
2

Aufgabendetails abfragen

Verwenden Sie Eine Runway-Aufgabe abrufen, bis die Aufgabe einen terminalen Zustand erreicht.
3

Das transformierte Ergebnis speichern

Laden Sie das fertige Asset herunter oder speichern Sie es über Ihre normale Medienpipeline.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version
string
erforderlich

Runway API version header, for example 2024-11-06.

Body

application/json
videoUri
string
Standard:https://your-video-host/source.mp4
erforderlich

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
Standard:A cat yawning in slow motion.
erforderlich

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
Standard:1
erforderlich

Random seed for reproducible results. Range: 0–4294967295.

model
string
Standard:gen4_aleph
erforderlich

Model variant to use.

references
object[]
erforderlich

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
Standard:1280:720
erforderlich

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
erforderlich

Antwort

200 - application/json

success

id
string
erforderlich

The ID of the task that was created. Use this to retrieve the task later.