RUrunwayml
Recipes

Swap a product in a reference video

Changed on

Replace the product in a reference video with a new product, preserving camera motion, lighting, and scene composition.

post/v1/recipes/product_swap

Request

  • Base URL
    https://api.dev.runwayml.com
  • Auth
    HTTP bearer

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

version'2026-06' | 'unsafe-latest' required

Workflow version. Use a dated version (e.g. "2026-06") to pin behavior, or "unsafe-latest" to track the newest stable version (may break without notice).

durationinteger

Duration of the output video in seconds (4-15). Defaults to 10 seconds.

resolution'720p' | '1080p'

Output video resolution. Defaults to 720p.

audioboolean

Whether to generate audio for the video.

Example request

{
  "referenceVideo": {
    "uri": "https://example.com/video.mp4"
  },
  "originalProductImage": {
    "uri": "https://example.com/image.jpg"
  },
  "newProductImages": [
    {
      "uri": "https://example.com/image.jpg"
    }
  ]
}

Response

The task that was created.

idstring uuid required

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

Changes