---
title: "Video Upscaler Precision - Upscale video"
method: POST
path: "/v1/ai/video-upscaler-precision"
tags: ["video-upscaler-precision"]
---

# Video Upscaler Precision - Upscale video

`POST /v1/ai/video-upscaler-precision`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/video-upscaler-precision`
- Auth: API key in header `x-magnific-api-key`

Upscales a video with precision-grade quality enhancement.
Designed for frame-accurate upscaling with fine-grained control over sharpening, grain, and output strength.
Supports output resolutions of 720p, 1k, 2k, or 4k with optional FPS boost.

## Request body

- RequestContent5
  - `video` string, required: Source video to upscale. Must be a publicly accessible HTTPS URL pointing to the video.
  - `resolution` '720p' | '1k' | '2k' | '4k': Output resolution for the video upscaling: - `720p`: HD output - `1k`: Standard definition output - `2k`: High definition output (default) - `4k`: Ultra high definition output
  - `fps_boost` boolean: 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: 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.
  - `smart_grain` integer: 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.
  - `strength` integer: 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.
  - `output_format` 'h264' | 'prores_422_hq': 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.
  - `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 `200`

OK - Task created. The X-Frames-Billed header indicates the number of frames billed for B2B users.

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)