Zum Hauptinhalt springen
POST
/
runwayml
/
v1
/
image_to_video
Create a Runway image-to-video task
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"
}
'
{
  "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