GET
/v1/schemas/fal/video/fal-ai%2Fkling-video%2Fv3%2Fpro%2Fmotion-control
Accept:
Request body
6 properties · 3 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | Reference image URL. The characters, backgrounds, and other elements in the generated video are based on this reference image. Characters should have clear body proportions, avoid occlusion, and occupy more than 5% of the image area. | |
| character_orientation* | enum | Controls whether the output character's orientation matches the reference image or video. 'video': orientation matches reference video - better for complex motions (max 30s). 'image': orientation matches reference image - better for following camera movements … | image | video |
| video_url* | string | Reference video URL. The character actions in the generated video will be consistent with this reference video. Should contain a realistic style character with entire body or upper body visible, including head, without obstruction. Duration limit depends on ch… | |
| keep_original_sound | boolean | Whether to keep the original sound from the reference video. | default: true |
| elements | KlingV3ImageElementInput[] | Optional element for facial consistency binding. Upload a facial element to enhance identity preservation in the generated video. Only 1 element is supported. Reference in prompt as @Element1. Element binding is only supported when character_orientation is 'video'. | nullable |
| prompt | string | length ≤ 2500 · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/kling-video/v3/pro/motion-control","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}