GET
/v1/schemas/runway/video/v1/recipes/product_ugc
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracecbe9ae85cc6ad0ff714fd5ad664993f943b9d51a6155383212951177e4bc2acb{
"fetchedAt": 1786771313,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 3 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 |
| characterImage* | object | Image of the character who will appear on camera in the UGC video. Aspect ratio (width / height) must be between 0.4 and 4. See [our docs](/assets/inputs#images) for image input requirements. | |
| productImage* | object | Image of the product being promoted. Aspect ratio (width / height) must be between 0.4 and 4. See [our docs](/assets/inputs#images) for image input requirements. | |
| productInfo | string | Product details and creative brief - what the product is, key benefits, and any specifics the script should reference. | length ≤ 2500 · default: "" |
| userConcept | string | Optional creative direction for the UGC video - tone, voice register, specific message, or an entire dialog script. | length ≤ 3500 · default: "" |
| duration | integer | Duration of the output video in seconds (4-15). Defaults to 15 seconds. | 4 ≤ n ≤ 15 |
| ratio | enum | The resolution of the output video. | 720:1280 | 1080:1920 |
| 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_ugc","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}