GET

/v1/schemas/fal/video/kling/v4/video-to-video/edit

Accept:

kind inputactivity videohash ef55867c…extracted Nov 5, 2026version currentsource upstream spec ↗

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

Request body

12 properties · 2 required · 1 $defs

property	type	description	constraints
video_url*	string	The video to edit (3-30s), referenced as @Video1.
prompt*	string	Edit instruction. Reference the source video as @Video1.	length ≤ 26000
image_urls	string[]	Reference images, referenced as @Image1, @Image2, ...	items ≤ 10 · nullable
end_image_url	string	Optional image to use as the last frame. Counts toward the image reference limit.	nullable
aspect_ratio	enum	Aspect ratio of the edited video. 'auto' adapts it to the inputs. Omit to follow the source video.	auto \| 16:9 \| 9:16 \| 1:1 \| 21:9 · nullable
resolution	enum	Output resolution.	720p \| 1080p · default: "1080p"
video_urls	string[]	Reference videos, referenced as @Video2, @Video3, ... (max 4). The source, reference and element videos must total at most 30s.	items ≤ 4 · nullable
elements	KlingV4Element[]	Characters/objects, referenced as @Element1, @Element2, ... (max 7). Up to 3 elements may carry a voice_id and up to 3 may be video elements.	items ≤ 7 · nullable
duration	integer	Output duration in seconds (3-30). Defaults to the source video's length.	3 ≤ n ≤ 30 · nullable
voice_ids	string[]	Voices referenced in the prompt as @Voice1, @Voice2, ... (max 3, including voices bound to elements). Create one with https://fal.ai/models/fal-ai/kling-video/create-voice	items ≤ 3 · nullable
middle_image_urls	string[]	Optional ordered keyframes between the first and last frames (max 8). Count toward the image reference limit.	items ≤ 8 · nullable
start_image_url	string	Optional image to use as the first frame. Counts toward the image reference limit.	nullable

Types

1 $defs

KlingV4Elementobject

frontal_image_url	string	The frontal image of the element (main view).	nullable
voice_id	string	Voice bound to this element. Create one with https://fal.ai/models/fal-ai/kling-video/create-voice	nullable
reference_image_urls	string[]	Additional views of the element from different angles (1-3).	items ≤ 3 · nullable
video_url	string	A video of the element, used instead of images (3-8s).	nullable

Validate a payload

before you spend tokens

shell

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