Sign in
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.

Changes

Changed in 3 of the 54 revisions of this API.4

  • 73a12c23285c2See the full diff
    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the required property to the response with the status

      response-required-property-added

  • 39fa7be65d801See the full diff
    • ○

      added the new 2026-07 enum value to the request property

      request-property-enum-value-added

  • 28f5cd401a4b1See the full diff
    • ○

      endpoint added

      endpoint-added