mingyan

Video Super Resolution - Create Task

Create a video super-resolution task to enhance a low-resolution video

POST/kyyReactApiServer/v1/super-resolution/videos

Video Super Resolution Create Task

Create a video super-resolution task. The API accepts a publicly accessible video URL, processes it asynchronously, and returns the enhanced video URL through the unified result query API.

Clients need to provide model and videoUrl. Resolution, FPS, and other processing settings are determined by the selected model tier and do not need to be passed separately.

Authentication

Get Key

All requests require a Bearer token in the request header:

cURL

Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

modelbodystringrequired

Video super-resolution model name.

Supported values:

superResolution-720p-lowfps
superResolution-720p-highfps
superResolution-1080p-lowfps
superResolution-1080p-highfps
superResolution-2k-lowfps
superResolution-2k-highfps
superResolution-4k-lowfps
superResolution-4k-highfps

videoUrlbodystringrequired

Input video URL. The URL must be publicly accessible.

Model Guide

Each model name has two parts:

720p, 1080p, 2k, or 4k indicates the target quality tier
lowfps or highfps indicates the FPS tier: lowfps is generally for videos at 30 FPS or below, while highfps is generally for videos above 30 FPS and below 120 FPS

Model	Target quality	FPS tier	Best for
`superResolution-720p-lowfps`	720p	Standard FPS	Lower-FPS videos, or cases where you only need clearer output with lower cost
`superResolution-720p-highfps`	720p	High FPS	Higher-FPS videos, or cases where smoother output is preferred
`superResolution-1080p-lowfps`	1080p	Standard FPS	General HD enhancement for most lower-FPS videos
`superResolution-1080p-highfps`	1080p	High FPS	General HD enhancement when smoother motion should be preserved
`superResolution-2k-lowfps`	2K	Standard FPS	Higher-resolution output when smoothness is less important
`superResolution-2k-highfps`	2K	High FPS	Higher-resolution output with smoother motion
`superResolution-4k-lowfps`	4K	Standard FPS	4K output when FPS is not the main priority
`superResolution-4k-highfps`	4K	High FPS	4K output while preserving smoother high-FPS motion as much as possible

Use lowfps for standard-FPS videos at 30 FPS or below. Use highfps for high-FPS videos above 30 FPS and below 120 FPS when smoother output matters; it usually costs more and takes longer to process.

Response Parameters

idstring

Unique identifier of the video super-resolution task. Use this ID to query task status.

objectstring

Object type, always video.

createdinteger

Task creation timestamp.

modelstring

Video super-resolution model name used to create the task.

statusstring

Task status:

queued - Queued
processing - Processing
completed - Completed
failed - Failed

errorstring

Error message, returned when the task is failed.

Billing

Video super-resolution is billed based on the input video duration. The unit price may vary by model tier. Billable duration is rounded up to whole seconds, and any duration shorter than 1 second is billed as 1 second.

Notes

Important:

Provide model and videoUrl
The input video URL must remain accessible while the task is processing
Resolution, FPS, and other processing settings are determined by the selected model tier
A successful create response only means the task has been submitted; query the result API for the final video