GET
/v1/schemas/runway/video/v1/recipes/product_ad
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracecbe9ae85cc6ad0ff714fd5ad664993f943b9d51a6155383212951177e4bc2acb{
"fetchedAt": 1786771313,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| version* | enum | 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). | 2026-06 | 2026-07 | unsafe-latest |
| productImages* | object[] | Product images (1-10). Multiple angles of the same product. All images inform product analysis and reference generation; only the first image is used as the primary product reference in the storyboard grid. See [our docs](/assets/inputs#images) on image inputs… | items ≥ 1 · items ≤ 10 |
| styleImages | object[] | Optional style reference images (0-4). Defines the visual treatment (lighting, palette, mood). Treated as a moodboard when multiple are provided. | items ≤ 4 |
| productInfo | string | Optional product description and specifications to inform creative direction and which product elements to highlight. | length ≤ 2500 · default: "" |
| userConcept | string | Optional creative direction describing brand voice, product framing, scene specifics, lighting, camera motion, and narrative. | length ≤ 3500 · default: "" |
| ratio | enum | The resolution of the output video. | 1280:720 | 720:1280 | 960:960 | 834:1112 | 1920:1080 | 1080:1920 · +2 more |
| duration | integer | Duration of the output video in seconds (4-15). Defaults to 10 seconds. | 4 ≤ n ≤ 15 |
| audio | boolean | Whether to generate audio for the video. | default: false |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"runway","endpointId":"v1/recipes/product_ad","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}