---
title: "Generate a video from a video"
method: POST
path: "/runwayml/v1/video_to_video"
---

# Generate a video from a video

`POST /runwayml/v1/video_to_video`

## Headers

- `X-Runway-Version` string, required

## Request body

- object
  - `videoUri` string, required — HTTPS URL of the source video, or a base64 data URI containing the video.
  - `promptText` string, required — Text prompt describing the desired output. Maximum 1000 characters.
  - `seed` integer, required — Random seed for reproducible results. Range: 0–4294967295.
  - `model` string, required — Model variant to use.
  - `references` object[], required — Optional reference images to guide generation. Each item must include `type` (e.g. `image`) and `uri` (HTTPS URL).
    - `type` string
    - `uri` string
  - `ratio` string, 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.
  - `contentModeration` object, required
    - `publicFigureThreshold` string, required — Threshold for public-figure detection. Use `auto` for default behavior.

## Response `200`

success

- object
  - `id` string, required — The ID of the task that was created. Use this to retrieve the task later.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)