提交视频超分任务

POST

/process/super_resolve/submit_task

接口功能

将一个视频提交并对他进行视频超分，返回任务 ID，并通过单独的查询接口获取最终超分结果。

适用场景

对低分辨率视频做清晰度增强和 2 倍尺寸放大，例如480p的视频会超分为960p, 1080p的视频会超分为4k.

输入说明

video_url：待超分视频的 URL

bit_rate：可选，输出视频码率，范围 1-20，默认 10

处理说明

服务会先检测输入视频时长

视频时长超过 30 秒会直接返回错误，不继续超分

校验通过后提交异步超分任务

超分结果为原视频宽高各 2 倍

输出说明

提交成功时返回 code=200 和 data.task_id

参数错误或超过时长限制返回 code=400

服务处理失败返回 code=500

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

任务提交成功

Bodyapplication/json

🟠400

🔴500

请求示例

Shell

JavaScript

Java

Swift

cURL

基础示例指定码率

curl --location 'https://open.vectcut.com/process/super_resolve/submit_task' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data '{
    "video_url": "https://player.install-ai-guider.top/example/super_resolve.mp4"
}'

响应示例

200 - 成功示例

{
    "code": 200,
    "data": {
        "bit_rate": 10,
        "duration_seconds": 9,
        "status": "SUBMITTED",
        "task_id": "3D3EA421-17DF-505F-9617-9C93A31B1BBF"
    },
    "message": "Success"
}

修改于 2026-06-07 08:59:55

插入首帧

查询视频超分任务状态

提交视频超分任务

接口功能#

适用场景#

输入说明#

处理说明#