# Topaz Labs Topaz Video Upscale API

> Upscale 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.

Source: https://www.sandbase.ai/models/topaz/upscale/video
API reference: https://www.sandbase.ai/models/topaz/upscale/video/docs

## Facts

- Provider: Topaz Labs
- Type: Video model
- Model ID: `topaz/upscale/video`
- Price: From $0.10 per run
- Capabilities: video to video
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "topaz/upscale/video",
  "video": "https://static.sandbase.ai/examples/topaz/upscale/video/input_video_0.mp4",
  "H264_output": false,
  "upscale_factor": 2
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Topaz Labs Topaz Video Upscale through SandBase?

Create a SandBase API key, then send requests with the model ID "topaz/upscale/video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Topaz Labs account?

No. One SandBase API key and balance gives you access to Topaz Labs Topaz Video Upscale and the other models in the catalog; you do not need to sign up with Topaz Labs separately.

## README

### 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`.
