GET

/v1/schemas/fal/video/fal-ai%2Ffilm%2Fvideo

kind inputactivity videohash eb5a605b…extracted Oct 9, 2026version currentsource upstream spec ↗

Request body

10 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
video_url*stringThe URL of the video to use for interpolation.
use_calculated_fpsbooleanIf True, the function will use the calculated FPS of the input video multiplied by the number of frames to determine the output FPS. If False, the passed FPS will be used.default: true
loopbooleanIf True, the final frame will be looped back to the first frame to create a seamless loop. If False, the final frame will not loop back.default: false
fpsintegerFrames per second for the output video. Only applicable if use_calculated_fps is False.1 ≤ n ≤ 60 · default: 8
video_write_modeenumThe write mode of the output video. Only applicable if output_type is 'video'.fast | balanced | small · default: "balanced"
use_scene_detectionbooleanIf True, the input video will be split into scenes before interpolation. This removes smear frames between scenes, but can result in false positives if the scene detection is not accurate. If False, the entire video will be treated as a single scene.default: false
enable_safety_checkerbooleanAuthorized callers may set false to request relaxed screening.default: true
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
video_qualityenumThe quality of the output video. Only applicable if output_type is 'video'.low | medium | high | maximum · default: "high"
num_framesintegerThe number of frames to generate between the input video frames.1 ≤ n ≤ 4 · default: 1

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/film/video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}