v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Runway image-to-video task

Submit a source image plus optional motion prompt and receive a task id for later polling.

post/runwayml/v1/image_to_video

Headers

X-Runway-Versionstring required

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

Request body

promptImagestring required

Source image URL.

seedinteger

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

modelstring required

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

promptTextstring

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

watermarkboolean

Whether to add a watermark to the output video.

durationinteger

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

ratiostring

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.

Response

Task accepted.

idstring required

Example response

{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79"
}