Ein Video aus einem Video erzeugen

Verwenden Sie CometAPI Runway POST /runwayml/v1/video_to_video, um Video-zu-Video-Generierungsaufgaben zu starten, X-Runway-Version festzulegen und Quellclips zu transformieren.

POST /runwayml/v1/video_to_video

Generate a video from a video

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "promptText": "string",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'

200

{}

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

​

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 Runway to Get Task Details, bis die Aufgabe einen terminalen Zustand erreicht.

3. Transformiertes Ergebnis speichern

   Laden Sie das fertige Asset herunter oder speichern Sie es über Ihre normale Medien-Pipeline.

​

Hinweis zum CometAPI-Wrapper

CometAPI behält Runways asynchrones Aufgabenmodell und das versionierte Anfrageverhalten bei, vereinheitlicht jedoch die Authentifizierung und die Handhabung der Basis-URL mit dem Rest der Plattform.

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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.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).

Show child attributes

ratio · string · Standard: 1280:720 · erforderlich

Aspect ratio of the output video, e.g. 1280:720.

contentModeration · object · erforderlich

Show child attributes

Antwort

200 - application/json

success

The response is of type object.