ByteDanceVideoEnhanceNode - ComfyUI Built-in Node Documentation

This node upscales and restores videos using ByteDance vCube. It can increase resolution up to 8K, remove compression artifacts and noise, enhance colour and sharpness, and optionally interpolate frames for a higher frame rate. The video is uploaded to the vCube service, processed with the selected enhancement preset, and returned as an enhanced video file.

Inputs

Common Inputs

These inputs are always visible.

Parameter	Description	Data Type	Required	Range
`video`	Video to enhance. The source resolution must be at most 2560x1440 (2K); the output size is set by the resolution input.	VIDEO	Yes	At most 2560x1440 (2K)
`tool_version`	’standard’ balances speed and quality with 10+ enhancement algorithms. ‘professional’ uses 30+ algorithms for cinema-grade restoration, takes about 3x longer and costs 10x more.	DYNAMIC_COMBO	Yes	”standard" "professional”
`resolution`	Output resolution. The short side is set to the chosen level and the long side follows the source aspect ratio. ‘source’ keeps the source size, ‘custom’ sets the short side in pixels. Sources wider or taller than about 2.2:1 are billed one resolution tier higher.	DYNAMIC_COMBO	Yes	”720p" "1080p" "2k" "4k" "8k" "source" "custom”
`fps`	Output frame rate. A higher rate than the source enables AI frame interpolation; a lower one drops frames. ‘source’ keeps the source rate, up to 120 fps. Rates above 30 fps cost 2x, above 60 fps 4x. (default: “source”)	COMBO	Yes	”source” (default) Numeric frame rates up to 120 fps
`bitrate_level`	Target bitrate of the delivered file, scaled to the output resolution and frame rate. (default: “medium”)	COMBO	Yes	”low" "medium" "high”

Standard Inputs

Shown when tool_version is set to “standard”.

Parameter	Description	Data Type	Required	Range
`scene`	Preset tuned to the content: ‘aigc’ for AI-generated footage, ‘common’ for general video, ‘ugc’ for compressed phone clips, ‘short_series’ for drama with faces, ‘old_film’ for scratched or flickering archive footage. (default: “aigc”)	COMBO	Yes	”aigc" "common" "ugc" "short_series" "old_film”
`enhance_style`	’hd’ applies a sharper enhancement; ‘natural’ reduces the strength for a softer, less sharpened look. (default: “hd”)	COMBO	Yes	”hd" "natural”

Professional Inputs

Shown when tool_version is set to “professional”.

Parameter	Description	Data Type	Required	Range
`enhance_style`	’hd’ applies a sharper enhancement; ‘natural’ reduces the strength for a softer, less sharpened look. (default: “hd”)	COMBO	Yes	”hd" "natural”

Custom Resolution Inputs

Shown when resolution is set to “custom”.

Parameter	Description	Data Type	Required	Range
`short_side`	Short side of the output in pixels; the long side follows the source aspect ratio. (default: 1080)	INT	Yes	Default 1080; bounded by vCube minimum and maximum short-side limits

Notes

The source video must be at most 2560x1440 (2K). Videos larger than this are rejected and must be scaled down before enhancing.
The source video duration is limited to the maximum duration supported by the vCube service.
When tool_version is “standard”, both scene and enhance_style are available. When it is “professional”, only enhance_style is available.
When resolution is “custom”, the short_side value is required. The resolution presets and “source” do not use short_side.
When resolution is “source”, the output keeps the source resolution.
When fps is “source”, the output frame rate matches the source frame rate, up to 120 fps.

Outputs

Output Name	Description	Data Type
`video`	The enhanced video, upscaled and restored at the requested resolution and frame rate.	VIDEO

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda

​Inputs

​Common Inputs

​Standard Inputs

​Professional Inputs

​Custom Resolution Inputs

​Notes

​Outputs