Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Recipes

Create a product ad video

Generate a cinematic product ad from product images, optional style references, product info, and creative direction.

post/v1/recipes/product_ad

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' | '2026-07' | 'unsafe-latest' required

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

productInfostring

Optional product description and specifications to inform creative direction and which product elements to highlight.

userConceptstring

Optional creative direction describing brand voice, product framing, scene specifics, lighting, camera motion, and narrative.

ratio'1280:720' | '720:1280' | '960:960' | '834:1112' | '1920:1080' | '1080:1920' | '1440:1440' | '1248:1664'

The resolution of the output video.

durationinteger

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

audioboolean

Whether to generate audio for the video.

Example request

{
  "productImages": [
    {
      "uri": "https://example.com/image.jpg"
    }
  ],
  "styleImages": [
    {
      "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.