Skip to main content
POST
cURL
Verwenden Sie diesen Endpoint, um ein einzelnes Quellbild zu einem Runway-Video zu animieren.

Bevor Sie ihn aufrufen

  • Senden Sie den erforderlichen Header X-Runway-Version, zum Beispiel 2024-11-06
  • Verwenden Sie model: gen3a_turbo
  • Geben Sie ein stabiles HTTPS-promptImage an
  • Beginnen Sie mit duration: 5 und einem unterstützten ratio-Wert für das ausgewählte Runway-Modell/die ausgewählte Version

Duration und ratio

Offizielle Anfragen im Runway-Format verwenden ratio, nicht size. Lesen Sie ratio-Werte im Auflösungsstil als ihr WxH-Äquivalent: 1280:720 zielt auf 1280x720, 720:1280 auf 720x1280, und 1280:768 kann je nach ausgewähltem Modell/ausgewählter Version weiterhin als 1280x720 gerendert werden.

Aufgabenablauf

1

Die image-to-video-Anfrage absenden

Erstellen Sie die Aufgabe mit einem Quellbild und einem optionalen kurzen Motion-Prompt.
2

Die zurückgegebene id speichern

Speichern Sie die Aufgaben-id für das spätere Polling.
3

Aufgabenstatus abfragen

Verwenden Sie Eine Runway-Aufgabe abrufen. Wenn die erste Abfrage task_not_exist zurückgibt, warten Sie einige Sekunden und versuchen Sie es erneut.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version
string
erforderlich

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

Body

application/json
promptImage
string
Standard:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
erforderlich

Source image URL.

model
string
Standard:gen3a_turbo
erforderlich

Runway image-to-video model ID. Choose an available model from the Models page.

seed
integer

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

promptText
string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark
boolean
Standard:false

Whether to add a watermark to the output video.

duration
integer
Standard:5

Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
Standard:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

Antwort

200 - application/json

Task accepted.

id
string
erforderlich