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

# Video Upscaler Turbo - Upscale video

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

## Request

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

Upscales a video using turbo processing with premium quality enhancement applied automatically.
Turbo mode reduces processing time while maintaining high visual quality.
Supports various output resolutions (720p, 1k, 2k, 4k) with optional creativity, sharpening, and grain controls.

## Request body

- RequestContent4
  - `video` string, required: Source video to upscale. Must be a publicly accessible HTTPS URL pointing to the video.
  - `creativity` integer: Creativity intensity. Controls how much creative freedom is applied during upscaling. Valid values range from 0 (no creativity) to 100 (maximum creativity). Default is 0.
  - `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.
  - `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.
  - `flavor` 'vivid' | 'natural': Video processing flavor that determines the upscaling style: - `vivid`: Enhanced colors and contrast for more vibrant output - `natural`: Preserves original colors and natural appearance
  - `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 - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, 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)