GET
/v1/schemas/fal/video/fal-ai/kling-video/o3/4k/video-to-video/reference
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace08addc01016ff25218e91d15aa561879b1f944a2fcbf61cc1a6d9bf33bdadaf9{
"fetchedAt": 1791954060,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | Reference video URL. Only .mp4/.mov formats, 3-15s duration, 720-3840px resolution, max 200MB. | |
| prompt* | string | Text prompt for video generation. Reference video as @Video1. | length ≤ 2500 |
| keep_audio | boolean | Whether to keep the original audio from the reference video. | default: true |
| duration | enum | Video duration in seconds (3-15s for reference video). | 3 | 4 | 5 | 6 | 7 | 8 · +7 more · nullable |
| aspect_ratio | enum | Aspect ratio. | auto | 16:9 | 9:16 | 1:1 · default: "auto" |
| elements | KlingV3ImageElementInput[] | Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2. | nullable |
| shot_type | const | The type of multi-shot video generation. | "customize" · default: "customize" |
| 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 $defsKlingV3ImageElementInputobject
| reference_image_urls | string[] | Additional reference images from different angles. 1-3 images supported. At least one image is required. | nullable |
| frontal_image_url | string | The frontal image of the element (main view). | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/kling-video/o3/4k/video-to-video/reference","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}