halonumber
Halo reduction level (0.0-1.0). Default varies by model.
Minimum: 0
Maximum: 1
Topaz Video Upscale
topaz/upscale/videoUpscale Video is Topaz Labs's video-to-video AI model. Transform, enhance, and edit video content using text prompts - from style changes to object manipulation and scene modification.
Try the model
Playground
Input
URL of the video to upscale
Additional Settings More
Customize your input with more control.
01
Noise reduction level (0.0-1.0). Default varies by model. Range: 0 to 1.
14
Factor to upscale the video by (e.g. 2.0 doubles width and height) Range: 1 to 4.
01
Halo reduction level (0.0-1.0). Default varies by model. Range: 0 to 1.
01
Compression artifact removal level (0.0-1.0). Default varies by model. Range: 0 to 1.
00.1
Film grain amount (0.0-0.1). Default varies by model. Range: 0 to 0.1.
01
Recover original detail level (0.0-1.0). Higher values preserve more original detail. Range: 0 to 1.
1660
Target FPS for frame interpolation. If set, frame interpolation will be enabled. Range: 16 to 60.
Whether to use H264 codec for output video. Default is H265.
ResultExample
What would you like to do next?
Examples
Select an example to load its inputs and result into the playground.
- Open result ↗
Input
{ "video": "https://static.sandbase.ai/examples/1e4dfe61-979e-46cb-b89b-febca05cad88/input/b80bd4f4-a0df-434c-98c9-e7f418ff0cb3.mp4" }
Topaz Video Upscale
Topaz upscales and enhances video, with optional frame interpolation to 60fps.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
video | video URL, required | — | Video to upscale. |
noise | number 0–1 | — | Noise reduction level (0.0-1.0). |
upscale_factor | number 1–4 | 2 | 1–4×. |
halo | number 0–1 | — | Halo reduction level (0.0-1.0). |
compression | number 0–1 | — | Compression artifact removal level (0.0-1.0). |
grain | number 0–0.1 | — | Film grain amount (0.0-0.1). |
recover_detail | number 0–1 | — | Recover original detail level (0.0-1.0). |
target_fps | integer 16–60 | — | Interpolate to this frame rate (16–60). |
H264_output | boolean | false | Whether to use H264 codec for output video. |
Billing
Per output second (minimum 5): $0.01 up to 720p, $0.02 up to 1080p, $0.08 above; 60fps doubles the rate.
| Output | 720p | 1080p | 4K |
|---|---|---|---|
| 10s | $0.10 | $0.20 | $0.80 |
Failed runs are not charged.
Also on SandBase
Related: bytedance/upscaler/video.
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "topaz/upscale/video",
"video": "https://static.sandbase.ai/examples/topaz/upscale/video/input_video_0.mp4",
"H264_output": false,
"upscale_factor": 2
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
grainnumber
Film grain amount (0.0-0.1). Default varies by model.
Minimum: 0
Maximum: 0.1
noisenumber
Noise reduction level (0.0-1.0). Default varies by model.
Minimum: 0
Maximum: 1
videostringrequired
URL of the video to upscale
target_fpsinteger
Target FPS for frame interpolation. If set, frame interpolation will be enabled.
Minimum: 16
Maximum: 60
H264_outputboolean
Whether to use H264 codec for output video. Default is H265.
Default: false
compressionnumber
Compression artifact removal level (0.0-1.0). Default varies by model.
Minimum: 0
Maximum: 1
recover_detailnumber
Recover original detail level (0.0-1.0). Higher values preserve more original detail.
Minimum: 0
Maximum: 1
upscale_factornumber
Factor to upscale the video by (e.g. 2.0 doubles width and height)
Default: 2
Minimum: 1
Maximum: 4
{
"model": "topaz/upscale/video",
"video": "https://static.sandbase.ai/examples/topaz/upscale/video/input_video_0.mp4",
"H264_output": false,
"upscale_factor": 2
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"poster": "https://static.sandbase.ai/examples/posters/85fcd8ed50a5b526b41c.jpg",
"source": "topaz schema mirror",
"source_url": "https://topaz.example/",
"url": "https://static.sandbase.ai/examples/1e4dfe61-979e-46cb-b89b-febca05cad88/output/6d5e0a6a-f6ea-44ac-9878-e9d6f9401f9e.mp4"
}
]