GET
/v1/schemas/fal/video/fal-ai/kling-video/o1/video-to-video/reference
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace15dce4d6fd2a36690969a265f09025c32ae9efcfad50ee7825a246df5f312a58{
"fetchedAt": 1791954060,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | Reference video URL. Only .mp4/.mov formats supported, 3-10 seconds duration, 720-2160px resolution, max 200MB. | |
| prompt* | string | Use @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order. | length ≤ 2500 |
| keep_audio | boolean | Whether to keep the original audio from the video. | default: false |
| 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. If 'auto', the aspect ratio will be determined automatically based on the input video, and the closest aspect ratio to the input video will be used. | auto | 16:9 | 9:16 | 1:1 · default: "auto" |
| elements | OmniVideoElementInput[] | Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2, etc. Maximum 4 total (elements + reference images) when using video. | nullable |
| image_urls | string[] | Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video. | 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/video-to-video/reference","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}