
BytePlus Video Upscaler API by BYTEPLUS
BytePlus AI MediaKit video quality enhancement (super-resolution): upscale/enhance a source video to up to 8K with scene-aware models (common/ugc/short_series/aigc/old_film), optional frame-rate interpolation and color/bitrate control.
BytePlus Video Upscaler is developed by BytePlus. Atlas Cloud (operated by Atlas Cloud AI LLC) provides access to it and does not own it. All trademarks belong to their respective owners.
BytePlus Video Upscaler
BytePlus Video Upscaler enhances an existing video to a higher output resolution and better quality using BytePlus AI MediaKit super-resolution. Provide a public video URL, pick the engine and target resolution, and receive a playable enhanced video URL.
Highlights
- Video-to-video enhancement: Improve an existing clip (up to 8K) without changing the source content.
- Scene-aware standard engine:
standarduses a scene template —common,ugc,short_series,aigc(AI-generated source), orold_film(degraded footage) — for fast, cost-effective results. - Professional engine:
professionalruns 30+ algorithms for the strongest quality (higher latency and ~10x the cost ofstandard). - Flexible output control: Target a fixed resolution (
240p–8k) or a short-edge pixel cap, tune the bitrate tier, and optionally interpolate the frame rate. - Hosted output: Enhanced videos are transferred to AtlasCloud storage and returned as long-lived URLs (the upstream URL expires in 24 hours and is never exposed).
Parameters
| Parameter | Required | Description |
|---|---|---|
model | Yes | Use byteplus/video/upscaler. |
video_url | Yes | Input video URL. Must be a publicly accessible HTTP(S) URL — BytePlus fetches it before processing, so signed URLs should be long-lived. |
tool_version | No | Engine: standard (default) or professional (~10x cost). |
scene | No | Scene template, only effective when tool_version=standard: common (default), ugc, short_series, aigc, old_film. |
resolution | No | Target output resolution: 240p, 360p, 480p, 540p, 720p, 1080p (default), 2k, 4k, 8k. Mutually exclusive with resolution_limit. |
resolution_limit | No | Target short-edge pixel cap [128, 4320], scaled proportionally. Mutually exclusive with resolution — if resolution is set, this is ignored. |
bitrate_level | No | Target bitrate tier: low, medium (default), high. |
fps | No | Target frame rate [15, 120] (frame interpolation). Omit to keep the source frame rate. Recommended not to exceed 4x the source fps. |
bit_depth | No | Color bit depth: 8 (default), 10, 12. Only effective when tool_version=professional. |
Note:
resolutionandresolution_limitcannot be set at the same time. If both are provided,resolutiontakes precedence andresolution_limitis dropped.
Example Request
{ "model": "byteplus/video/upscaler", "video_url": "https://static.atlascloud.ai/media/videos/af3ce4416487e61f8b299c5dc42642e3.mp4", "tool_version": "standard", "scene": "aigc", "resolution": "1080p" }
Processing
Enhancement is asynchronous. Submit a request to receive a task id, then poll the result endpoint until status is completed (or failed). A standard-engine 1-minute video typically takes about 6–10 minutes.
Pricing
Billing is per second of video duration (probed server-side via ffprobe before billing). The final price is the duration multiplied by a base per-second rate and a coefficient determined by the engine, target resolution, and frame rate:
price = duration_seconds × $0.00344333 × resolution_factor × fps_factor × version_factor
- Base rate:
$0.00344333 / second(equivalent to$0.2066 / minute). - Resolution factor:
720pand below = 1,1080p= 2,2K= 4,4K= 8,8K= 32. - Frame-rate factor: ≤30fps = 1, >30 and ≤60fps = 2, >60 and ≤120fps = 4.
- Version factor:
standard= 1,professional= 10.
When fps is omitted (source frame rate preserved) it is billed at the ≤60fps tier (factor 2); when resolution is omitted it is billed at the 1080p tier (factor 2).
Effective per-minute price (base × factors):
| Resolution | ≤30fps | ≤60fps | ≤120fps |
|---|---|---|---|
| 720p / below | $0.2066 | $0.4132 | $0.8264 |
| 1080p | $0.4132 | $0.8264 | $1.6528 |
| 2K | $0.8264 | $1.6528 | $3.3056 |
| 4K | $1.6528 | $3.3056 | $6.6112 |
| 8K | $6.6112 | $13.2224 | $26.4448 |
professional multiplies every cell above by 10.
Example: a 11-second professional job at 2K and 56fps → 11 × $0.00344333 × 4 × 2 × 10 = $3.03.


















