Skip to main content
POST
Video Upscaler Topaz - Upscale video

Authorizations

x-magnific-api-key
string
header
required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json
video
string
required

Source video to upscale. A publicly accessible HTTPS URL pointing to the video, or an uploaded file reference (upl_...).

enhancement_model
enum<string>
default:starlight_precise_2_5
required

Topaz Starlight enhancement model:

  • starlight_precise_2_5: highest-quality generative upscaler (default)
  • starlight_fast_2: faster generative upscaler with a slight trade-off in quality
Available options:
starlight_precise_2_5,
starlight_fast_2
resolution
enum<string>
default:2k

Output resolution for the video upscaling. The aspect ratio of the source video is preserved:

  • 720p: HD output
  • 1k: Standard definition output
  • 2k: High definition output (default)
  • 4k: Ultra high definition output
Available options:
720p,
1k,
2k,
4k
target_fps
integer

Target output frame rate. When it differs from the source frame rate, AI frame interpolation is applied (see frame_interpolation). Omit to keep the source frame rate. Note: frame interpolation requires a target of at least 15 fps.

Required range: 1 <= x <= 60
frame_interpolation
enum<string>
default:apollo

Frame interpolation model used when target_fps differs from the source frame rate:

  • apollo: recommended for most videos (default)
  • chronos: optimized for slow-motion and large frame-rate changes
Available options:
apollo,
chronos
noise
number
default:0

Noise reduction / addition intensity applied by the enhancement model. Valid values range from 0 to 1. Default is 0.

Required range: 0 <= x <= 1
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications when the upscaling task completes. The webhook will be called with the task status and the upscaled video URL.

Response

OK - Task created.

data
object
required
Example: