GET

/v1/schemas/fal/video/fal-ai/kling-video/v3/pro/motion-control

Accept:

kind inputactivity videohash 4a8b5bbf…extracted Oct 14, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `9fbdff9010f9cc48e53d1ad113d0e235937a2b88c3a5c3609843803e50b494ec` { "fetchedAt": 1791954060, "extractorVersion": "1", "verifiedAt": null }

Request body

7 properties · 3 required · 1 $defs

property	type	description	constraints
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
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.
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…
enable_safety_checker	boolean	Disabling safety checks requires account authorization; unauthorized requests are always checked.	default: true
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

Types

1 $defs

KlingV3ImageElementInputobject

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 tokens

shell

$ 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", …}]}