Skip to main content
Endpoint: POST https://fal.run/fal-ai/topaz/upscale/video Endpoint ID: fal-ai/topaz/upscale/video

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/topaz/upscale/video",
    arguments={
        "video_url": "https://v3.fal.media/files/kangaroo/y5-1YTGpun17eSeggZMzX_video-1733468228.mp4"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Examples

​
Input Schema

​
video_url
string
required
URL of the video to upscale
​
model
ModelEnum
default:"Proteus"
Video enhancement model. Proteus is best for most videos, Artemis for denoise+sharpen, Nyx for dedicated denoising, Gaia HQ/CG for rendered content, Gaia 2 for animation and motion graphics at 2x, and Starlight for generative diffusion-based upscaling and enhancement. Default value: "Proteus"Possible values: Proteus, Artemis HQ, Artemis MQ, Artemis LQ, Nyx, Nyx Fast, Nyx XL, Nyx HF, Gaia HQ, Gaia CG, Gaia 2, Starlight Precise 1, Starlight Precise 2, Starlight Precise 2.5, Starlight HQ, Starlight Mini, Starlight Sharp, Starlight Fast 1, Starlight Fast 2
​
upscale_factor
float
default:"2"
Factor to upscale the video by (e.g. 2.0 doubles width and height) Default value: 2Range: 1 to 4
​
target_fps
integer
Target FPS for frame interpolation. If set, frame interpolation will be enabled.Range: 16 to 60
​
compression
float
Compression artifact removal level (0.0-1.0). Default varies by model.Range: 0 to 1
​
noise
float
Noise reduction level (0.0-1.0). Default varies by model.Range: 0 to 1
​
halo
float
Halo reduction level (0.0-1.0). Default varies by model.Range: 0 to 1
​
grain
float
Film grain amount (0.0-1.0). Default varies by model.Range: 0 to 1
​
recover_detail
float
Recover original detail level (0.0-1.0). Higher values preserve more original detail.Range: 0 to 1
​
H264_output
boolean
default:"false"
Whether to use H264 codec for output video. Default is H265.

​
Output Schema

​
video
File
required
The upscaled video file

​
Input Example

{
  "video_url": "https://v3.fal.media/files/kangaroo/y5-1YTGpun17eSeggZMzX_video-1733468228.mp4",
  "model": "Proteus",
  "upscale_factor": 2,
  "H264_output": false
}

​
Output Example

{
  "video": {
    "url": "https://v3.fal.media/files/penguin/ztj_LB4gQlW6HIfVs8zX4_upscaled.mp4"
  }
}

​
Limitations

  • upscale_factor range: 1 to 4
  • target_fps range: 16 to 60
  • compression range: 0 to 1
  • noise range: 0 to 1
  • halo range: 0 to 1
  • grain range: 0 to 1
  • recover_detail range: 0 to 1