GET
/v1/schemas/fal/video/fal-ai%2Fbytedance-upscaler%2Fupscale%2Fvideo
Accept:
Request body
8 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | The URL of the video to upscale. | |
| fidelity | enum | The enhancement intensity. 'high' applies mild enhancement while keeping visual texture close to the source video. 'medium' provides a balanced image quality enhancement. | high | medium · default: "high" |
| enhancement_preset | enum | The enhancement preset optimized for specific video scenarios. 'general' is a general-purpose template, 'ugc' targets user-generated short videos, 'short_series' is for short dramas, 'aigc' is for AI-generated content, and 'old_film' is for classic film restor… | general | ugc | short_series | aigc | old_film · default: "general" |
| scale_ratio | number | The scaling ratio for the output video resolution. When set, overrides target_resolution and scales the input resolution by this factor (e.g., 2.0 doubles the resolution). Range: 1.1 to 10.0. Please note that this is valid only up to 4k resolution, and trying to scale beyond 4k will result in an error. (4k is defined as having atotal pixel count of 3840x2160). | 1.1 ≤ n ≤ 10 · nullable |
| target_fps | number | The target frame rate of the enhanced video in frames per second. | 24 ≤ n ≤ 120 · default: 30 |
| target_resolution | enum | The target resolution of the video to upscale. | 1080p | 2k | 4k | 6k | 8k · default: "1080p" |
| bit_depth | enum | The color bit depth of the output video. 10-bit and 12-bit output require the Pro enhancement tier. | 8 | 10 | 12 · default: 8 |
| enhancement_tier | enum | The enhancement quality tier. 'fast' provides essential upscaling with good speed, 'standard' uses adaptive algorithms for better visual texture, 'pro' uses large-model restoration for cinematic quality (longer processing time), and 10 times the cost of `stand… | fast | standard | pro · default: "standard" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/bytedance-upscaler/upscale/video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}