GET
/v1/schemas/fal/video/fal-ai/kling-video/o1/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace867e9ea175a9d825f1bf5d0739f350c28d683bd30730a2aaf01be70003258f62{
"fetchedAt": 1791954060,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
6 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order. | length ≤ 2500 |
| duration | enum | Video duration in seconds. | 3 | 4 | 5 | 6 | 7 | 8 · +2 more · default: "5" |
| aspect_ratio | enum | The aspect ratio of the generated video frame. | 16:9 | 9:16 | 1:1 · default: "16:9" |
| image_urls | string[] | Additional reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images + start image). | nullable |
| elements | OmniVideoElementInput[] | Elements (characters/objects) to include in the video. Reference in prompt as @Element1, @Element2, etc. Maximum 7 total (elements + reference images + start image). | nullable |
| enable_safety_checker | boolean | Disabling safety checks requires account authorization; unauthorized requests are always checked. | default: true |
Types
1 $defsOmniVideoElementInputobject
| reference_image_urls | string[] | Additional reference images from different angles. 1-3 images supported. At least one image is required. | |
| frontal_image_url* | string | The frontal image of the element (main view). |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/kling-video/o1/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}