GET

/v1/schemas/fal/video/fal-ai/ffmpeg-api/merge-videos

Accept:

kind inputactivity videohash 7d6f0fc1…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `ce77359dd35079a05bbca1443687a0bfc8e6c62ca9f71c1cfbb8f4909e4642b2` { "fetchedAt": 1783329138, "extractorVersion": "1", "verifiedAt": null }

Request body

4 properties · 1 required · 1 $defs

property	type	description	constraints
video_urls*	string[]	List of video URLs to merge in order	items ≥ 2
resolution_aspect_ratio_video_index	integer	Zero-based index of the input video whose aspect ratio should be used when resolution is not provided. If omitted, preserves the default behavior of using the minimum width and minimum height across input videos.	n ≥ 0 · nullable
target_fps	number	Target FPS for the output video. If not provided, uses the lowest FPS from input videos.	1 ≤ n ≤ 60 · nullable
resolution	ImageSize \| enum	Resolution of the final video. Width and height must be between 512 and 2048.	nullable

Types

1 $defs

ImageSizeobject

height	integer	The height of the generated image.	0 < n ≤ 14142 · default: 512
width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/ffmpeg-api/merge-videos","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}