Bild zu Video

Verwenden Sie CometAPI, um Runway image_to_video aufzurufen und eine statische Bild-URL in eine rohe Videoausgabe umzuwandeln, mit Unterstützung für X-Runway-Version zur Kompatibilität.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

Verwenden Sie diesen Endpunkt, um ein Quellbild zu animieren und in ein Runway-Video umzuwandeln.

​

Bevor Sie ihn aufrufen

• Senden Sie den erforderlichen Header X-Runway-Version, zum Beispiel 2024-11-06
• Verwenden Sie model: gen3a_turbo
• Stellen Sie ein stabiles HTTPS-promptImage bereit
• Beginnen Sie mit duration: 5 und einem gängigen Verhältnis wie 1280:720

​

Aufgabenablauf

1. Senden Sie die Bild-zu-Video-Anfrage

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

2. Speichern Sie die zurückgegebene id

   Speichern Sie die Aufgaben-id für späteres Polling.

3. Fragen Sie den Aufgabenstatus ab

   Verwenden Sie Get Task Details. Wenn die erste Abfrage task_not_exist zurückgibt, warten Sie einige Sekunden und versuchen Sie es erneut.

Die Live-Validierung am 2026-03-13 bestätigte, dass eine minimale gen3a_turbo-Anfrage akzeptiert wurde und eine id zurückgab. Nach einer kurzen Verzögerung lieferten sowohl die offiziellen Aufgabendetails als auch das umgekehrte feed denselben verpackten Warteschlangenstatus für diese Aufgabe zurück.

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 a current 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. Accepted values: 5 or 10.

ratio · enum<string> · Standard: 1280:720

Aspect ratio of the output video.

Verfügbare Optionen: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Antwort

200 - application/json

Task accepted.

id · string · erforderlich