bytedance/upscaler/video

Name: Bytedance Video Upscaler
Author: Bytedance

Bytedance Video Upscaler upscales videos to 4K resolution with AI-powered enhancement. Supports multiple quality tiers (fast, standard, pro), frame rate interpolation to 60fps, and presets optimized for UGC, short series...

Input

Video Url(string)

The URL of the video to upscale.

Enhancement Preset(string)

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 restoration. Allowed values: general, ugc, short_series, aigc, old_film.

Scale Ratio(number)

1.110

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). Range: 1.1 to 10.

Target Resolution(string)

The target resolution of the video to upscale. Allowed values: 1080p, 2k, 4k.

Target Fps(string)

The target FPS of the video to upscale. Allowed values: 30fps, 60fps.

Enhancement Tier(string)

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 `standard` and `fast`. Allowed values: fast, standard, pro.

Fidelity(string)

The enhancement intensity. 'high' applies mild enhancement while keeping visual texture close to the source video. 'medium' provides a balanced image quality enhancement. Allowed values: high, medium.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDbytedance/upscaler/video

Input Schema

7 parameters · 0 required · 7 optional

Parameter	Type	Required	Description
`video`	string	Optional	The URL of the video to upscale.
`fidelity`	string	Optional	The enhancement intensity. 'high' applies mild enhancement while keeping visual texture close to the source video. 'medium' provides a balanced image quality enhancement. · Options: high, medium · Default: "high" highmedium
`target_fps`	string	Optional	The target FPS of the video to upscale. · Options: 30fps, 60fps · Default: "30fps" 30fps60fps
`scale_ratio`	number	Optional	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). · Min: 1.1 · Max: 10
`enhancement_tier`	string	Optional	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 `standard` and `fast`. · Options: fast, standard, pro · Default: "standard" faststandardpro
`target_resolution`	string	Optional	The target resolution of the video to upscale. · Options: 1080p, 2k, 4k · Default: "1080p" 1080p2k4k
`enhancement_preset`	string	Optional	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 restoration. · Options: general, ugc, short_series, aigc, old_film · Default: "general" generalugcshort_seriesaigcold_film

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "bytedance/upscaler/video",
  "video": "https://static.sandbase.ai/examples/bytedance/upscaler/video/input_video_0.mp4",
  "fidelity": "high",
  "target_fps": "30fps",
  "enhancement_tier": "standard",
  "target_resolution": "1080p",
  "enhancement_preset": "general",
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Bytedance Video Upscaler

API README

Bytedance Video Upscaler

bytedance/upscaler/video upscales existing footage toward 1080p, 2K, or 4K while improving perceived detail across the entire clip. Temporal enhancement is applied consistently from frame to frame, reducing the shimmer and changing texture that can appear when still-image sharpening is applied independently to video. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work, Scenario presets and fidelity choices allow restoration to be balanced against source preservation, while 30 fps and 60 fps delivery cover conventional and high-motion masters. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Temporal detail recovery improves clarity without introducing frame-to-frame texture flicker.

Resolution enhancement supports 1080p, 2K, and 4K finishing targets.

Scenario-aware restoration adapts enhancement to different footage characteristics.

Motion-consistent processing preserves moving subjects and camera transitions during enlargement.

Pricing

Billing unit	Price
Per request	$0.0072

When to Use

✅ Good fit	❌ Consider alternatives
The model's named workflow matches the source material and intended output	A different input modality or model route is required
A managed asynchronous result is suitable for the production pipeline	A synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or format	The project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structure	Exact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverable	Editable source layers or a native project file are required

Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "video": "https://static.sandbase.ai/examples/bytedance/upscaler/video/input_video_0.mp4"
}

Technical Specs

Spec	Value
Model ID	`bytedance/upscaler/video`
Inputs	enhancement_preset, enhancement_tier, fidelity, scale_ratio, target_fps, target_resolution, video
Required inputs	None
Output fields	content_type, url
Execution	Async (submit, then poll for result)