GET

/v1/schemas/fal/video/fal-ai/workflow-utilities/scale-video

Accept:

kind inputactivity videohash 6344c8c9…extracted Jul 6, 2026version currentsource upstream spec ↗

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

Request body

8 properties · 1 required · 0 $defs

property	type	description	constraints
video_url*	string	URL of the video file to scale/resize. Height and Width of the video must be even numbers for compatibility with video codecs.
codec	enum	Video codec to use for encoding. libx264 (H.264) is widely compatible, libx265 (H.265/HEVC) offers better compression.	libx264 \| libx265 · default: "libx264"
height	integer	Target height in pixels. If only height is provided, width is auto-calculated to preserve aspect ratio. At least one of width or height must be provided.	2 ≤ n ≤ 4320 · nullable
mode	enum	Scaling mode. 'stretch' scales the video to the exact target dimensions (may distort aspect ratio). 'pad' scales to fit within the target dimensions while preserving aspect ratio, then pads with the chosen color to fill the remaining space (letterbox/pillarbox…	stretch \| pad \| crop · default: "stretch"
pad_color	enum	Padding color when mode is 'pad'. Ignored for other modes.	black \| white \| red \| green \| blue \| gray · default: "black"
crf	integer	Constant Rate Factor for quality (0-51). Lower values mean better quality and larger files. 18 is visually lossless for most content.	0 ≤ n ≤ 51 · default: 18
width	integer	Target width in pixels. If only width is provided, height is auto-calculated to preserve aspect ratio. At least one of width or height must be provided.	2 ≤ n ≤ 7680 · nullable
preset	enum	Encoding speed preset. Slower presets give better compression but take longer.	ultrafast \| fast \| medium \| slow · default: "fast"

Validate a payload

before you spend tokens

shell

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