v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Generate a video from a video

post/runwayml/v1/video_to_video

Headers

X-Runway-Versionstring required

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

Request body

videoUristring required

HTTPS URL of the source video, or a base64 data URI containing the video.

promptTextstring required

Text prompt describing the desired output. Maximum 1000 characters.

seedinteger required

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

modelstring required

Model variant to use.

ratiostring required

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

Response

success

idstring required

The ID of the task that was created. Use this to retrieve the task later.

Example response

{
  "id": "12a01a5e-ab55-4aa7-b002-7b873546cf76"
}