GET

/v1/schemas/fal/video/fal-ai/kling-video/o3/4k/reference-to-video

Accept:

kind inputactivity videohash 982f90b1…extracted Oct 14, 2026version currentsource upstream spec ↗

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

Request body

11 properties · 0 required · 2 $defs

property	type	description	constraints
duration	enum	Video duration in seconds (3-15s).	3 \| 4 \| 5 \| 6 \| 7 \| 8 · +7 more · default: "5"
end_image_url	string	Image to use as the last frame of the video.	nullable
aspect_ratio	enum	The aspect ratio of the generated video frame.	16:9 \| 9:16 \| 1:1 · default: "16:9"
elements	KlingV3ComboElementInput[]	Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2.	nullable
shot_type	enum	The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure.	customize \| intelligent · default: "customize"
prompt	string	Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.	length ≤ 2500 · nullable
generate_audio	boolean	Whether to generate native audio for the video.	default: false
start_image_url	string	Image to use as the first frame of the video.	nullable
image_urls	string[]	Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images) is allowed.	nullable
multi_prompt	KlingV3MultiPromptElement[]	List of prompts for multi-shot video generation.	nullable
enable_safety_checker	boolean	Disabling safety checks requires account authorization; unauthorized requests are always checked.	default: true

Types

2 $defs

KlingV3ComboElementInputobject

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
voice_id	string	The voice ID for this element. The voice will be binded to the element and references to this element will use the binded voice. Get voice IDs from the following endpoint: https://fal.ai/models/fal-ai/kling-video/create-voice	nullable
video_url	string	The video URL of the element. A request can only have one element with a video.	nullable

KlingV3MultiPromptElementobject

duration	enum	The duration of this shot in seconds	1 \| 2 \| 3 \| 4 \| 5 \| 6 · +9 more · default: "5"
prompt*	string	The prompt for this shot.

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/kling-video/o3/4k/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}