Recipes

Create a product ad video

Changed on

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

post/v1/recipes/product_ad

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/recipes/product_ad
  • 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' | '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.

Changes

  • ef7e1923afafRevision changes
    • info

      added the optional property to the response with the status

  • 73a12c23285cRevision changes
    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status