mingyan

视频超分 - 创建任务

创建视频超分任务，将低分辨率视频增强为更高清的视频

POST/kyyReactApiServer/v1/super-resolution/videos

视频超分创建任务

创建视频超分任务。接口接收公网可访问的视频 URL，异步完成视频清晰度增强，并通过统一查询接口返回结果视频地址。

客户端需要传入 model 和 videoUrl。分辨率、帧率等处理参数由 model 对应的档位决定，不需要额外传入。

所有请求都需要在请求头中包含 Bearer token：

cURL

Authorization: Bearer {{key}}

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

modelbodystring必填

视频超分模型名称。

可选值：

videoUrlbodystring必填

待超分视频 URL，必须是公网可访问的视频地址。

模型名由两部分组成：

720p、1080p、2k、4k 表示目标清晰度档位
lowfps、highfps 表示帧率档位：lowfps 一般用于 30 FPS 或以下视频，highfps 一般用于 30 FPS 以上、120 FPS 以下视频

模型	目标清晰度	帧率档位	适用场景
`superResolution-720p-lowfps`	720p	普通帧率	原视频帧率不高，或只需要提升清晰度、控制成本
`superResolution-720p-highfps`	720p	高帧率	原视频帧率较高，或希望结果更流畅
`superResolution-1080p-lowfps`	1080p	普通帧率	常规高清视频增强，适合大多数低帧率视频
`superResolution-1080p-highfps`	1080p	高帧率	常规高清视频增强，同时希望保留更高流畅度
`superResolution-2k-lowfps`	2K	普通帧率	需要更高清晰度，但对流畅度要求不高
`superResolution-2k-highfps`	2K	高帧率	需要更高清晰度，同时希望结果更流畅
`superResolution-4k-lowfps`	4K	普通帧率	需要 4K 清晰度，但对帧率要求不高
`superResolution-4k-highfps`	4K	高帧率	需要 4K 清晰度，并希望尽量保留高帧率流畅度

lowfps 适合 30 FPS 或以下的普通帧率视频，处理成本相对更低；highfps 适合 30 FPS 以上、120 FPS 以下的高帧率视频，结果通常更流畅，但费用和处理时间也会更高。

idstring

视频超分任务的唯一标识符，用于后续查询任务状态。

objectstring

对象类型，固定为 video。

createdinteger

任务创建时间戳。

modelstring

创建任务时使用的视频超分模型名称。

statusstring

任务状态：

errorstring

错误信息，当任务状态为 failed 时返回。

视频超分按照传入视频时长计费，不同模型档位对应的单价可能不同。计费时长按秒向上取整，不足 1 秒按 1 秒计算。

重要提示：