GET
/v1/schemas/runway/video/v1/recipes/product_swap
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracecbe9ae85cc6ad0ff714fd5ad664993f943b9d51a6155383212951177e4bc2acb{
"fetchedAt": 1786771313,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
7 properties · 4 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| version* | enum | 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). | 2026-06 | unsafe-latest |
| referenceVideo* | object | Reference video containing the product to swap. Duration must be between 1.8 and 15 seconds. See [our docs](/assets/inputs#videos) on video inputs. | |
| originalProductImage* | object | Image of the original product being swapped out. See [our docs](/assets/inputs#images) on image inputs. | |
| newProductImages* | object[] | Reference images of the new product (1-10). Supply multiple angles when the reference video shows the product from different views - optionally label each with `view` ("front", "side", or "back"). A single pre-composed reference sheet is also supported (omit `… | items ≥ 1 · items ≤ 10 |
| duration | integer | Duration of the output video in seconds (4-15). Defaults to 10 seconds. | 4 ≤ n ≤ 15 |
| resolution | enum | Output video resolution. Defaults to 720p. | 720p | 1080p |
| audio | boolean | Whether to generate audio for the video. | default: true |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"runway","endpointId":"v1/recipes/product_swap","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}