Skip to main content
POST
Video Upscaler Precision - 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. Must be a publicly accessible HTTPS URL pointing to the video.

resolution
enum<string>
default:2k

Output resolution for the video upscaling:

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

Enable FPS boost to increase the frame rate of the upscaled video. When enabled, the strength parameter is ignored and the fully upscaled result is returned.

sharpen
integer
default:0

Video sharpness intensity control. Higher values increase edge definition and clarity. Valid values range from 0 (no sharpening) to 100 (maximum sharpness). Default is 0.

Required range: 0 <= x <= 100
smart_grain
integer
default:0

Applies a film grain effect to the output video. Helps preserve natural film grain and texture detail. Valid values range from 0 (no grain) to 100 (maximum grain). Default is 0.

Required range: 0 <= x <= 100
strength
integer
default:60

Strength of the upscaling effect. Controls how much the output differs from the original video. A value of 0 returns the original video, 100 returns the fully upscaled result. Intermediate values blend the original with the upscaled result. This parameter is ignored when fps_boost is enabled. Default is 60.

Required range: 0 <= x <= 100
output_format
enum<string>
default:h264

Output video format. h264 (default) returns an H.264 MP4. prores_422_hq returns an Apple ProRes 422 HQ master (.mov) alongside an H.264 preview. When prores_422_hq is selected the completed task's generated array contains both files: the H.264 MP4 preview and the ProRes master, which can be identified by its .mov extension.

Available options:
h264,
prores_422_hq
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. The X-Frames-Billed header indicates the number of frames billed for B2B users.

data
object
required
Example: