积度探索 API 系统 · 视频超分服务介绍

适用产品

🚀 积度探索 AI

能力类型

📹 视频超分 / 画面增强 / 智能插帧

参考接口

🔌 提交任务 /v1/video/generations

1. 能力概述

视频超分服务用于将低分辨率视频智能提升至更高分辨率，同时增强画面细节、主体清晰度、边缘锐度，并通过智能插帧提高运动丝滑感。适用于低清素材高清化、AIGC 视频放大、短视频画质增强、老旧视频修复、媒资高清重制等场景。

积度探索 API 提供 标准版、专业版、大模型版 三档能力，统一封装为异步接口。三个版本共用 POST /v1/video/generations，通过 model 区分。用户提交公网可访问的视频 URL，任务完成后即可获取增强后的高分辨率视频。

1.1 版本怎么选

版本	模型 ID	输出上限	适用场景
标准版	`volc-mediakit-enhance-video`	最高 4K	常规超分、短视频、按场景模板（AIGC / 短剧 / UGC / 老片）批量处理
专业版	`volc-mediakit-enhance-video-professional`	最高 8K	更高画质要求、大屏交付；不支持 `scene`
大模型版	`volc-mediakit-enhance-video-generative`	720p / 1080p / 2K	AIGC「先低清生成、后增强」：480p 升 1080p/2K，语义补全细节；不支持 `scene`

2. 核心能力

🎬视频超分

标准版最高 4K，专业版最高 8K，大模型版支持 720p / 1080p / 2K。

⚡智能插帧

最高支持 120fps。不传 fps 时保持原片帧率；高于原片时触发智能插帧。

🔍细节增强

增强人物面部、服饰、物体纹理、背景风景等局部细节。大模型版还可语义补全被压缩破坏的像素。

✨清晰度提升

改善对焦模糊、低清拍摄、网络压缩等导致的画质下降。

🤫智能降噪

压制噪点、压缩马赛克、色带、蚊噪等伪影，还原更平滑的画面。

🎨色彩优化

自适应调整亮度、对比度与饱和度，使色彩更饱满通透。

3. 适用场景

🤖AIGC 低清生成 + 后期增强：用大模型版把 480p 成片提升到 1080p/2K，相对模型直出高清可明显降低生成成本。标准版也可对 AIGC 素材做常规超分（scene=aigc）。

🎬短剧超清化：标准版使用 scene=short_series；对画质要求更高时改用专业版。

📱短视频平台优化：消除二次压缩造成的块效应与清晰度劣化（标准版 scene=ugc）。

🎥老旧媒资修复：标准版使用 scene=old_film；需要更高输出规格时使用专业版。

4. 计费说明

三个版本都按输出时长（秒）× 基准单价 × 分辨率系数 × 帧率系数结算。基准单价对应「720P 且 ≤30fps」这一档；更高分辨率或更高帧率只乘系数，不再改单价。

最终费用：

4.1 每秒基准单价（720P ≤30fps）

版本	模型 ID	基准单价
标准版	`volc-mediakit-enhance-video`	以控制台该模型「每秒价格」为准
专业版	`volc-mediakit-enhance-video-professional`	建议 0.125 元/秒（即 7.5 元/分钟）
大模型版	`volc-mediakit-enhance-video-generative`	建议 0.041667 元/秒（即 2.5 元/分钟）

4.2 标准版系数

分辨率：720P=1 / 1080P=2 / 2K=4 / 4K=8
帧率：≤30fps=1，>30fps=2

输出分辨率	输出帧率	最终系数
720P 及以下	≤ 30fps	1
720P 及以下	> 30fps	2
1080P 及以下	≤ 30fps	2
1080P 及以下	> 30fps	4
2K 及以下	≤ 30fps	4
2K 及以下	> 30fps	8
4K 及以下	≤ 30fps	8
4K 及以下	> 30fps	16

4.3 专业版 / 大模型版系数

分辨率：720P=1 / 1080P=2 / 2K=4 / 4K=8 / 8K=32（大模型版请求侧最高 2K）
帧率：≤30fps=1 / ≤60fps=2 / ≤120fps=4

输出分辨率	≤30fps	≤60fps	≤120fps
720P 及以下	1	2	4
1080P 及以下	2	4	8
2K 及以下	4	8	16
4K 及以下（仅专业版）	8	16	32
8K 及以下（仅专业版）	32	64	128

计费示例（大模型版）：输出 7.083 秒、1080P、≤30fps，单价 0.041667 元/秒。

0.041667 × 7.083 × 2 × 1 ≈ 0.590 元

任务提交时会按预估时长预扣，完成后按实际上游返回时长多退少补。

5. 推荐接入流程

步骤 1

准备视频公网 URL

提供公网可直接稳定拉取的 HTTP/HTTPS 视频链接

📂

↓

步骤 2

提交视频超分任务

向网关发送 POST /v1/video/generations，用 model 选择版本

🔌

↓

步骤 3

解析同步响应获取 Task ID

解析响应体获得全局唯一任务标识 id

🔑

↓

步骤 4

低频轮询查询任务状态

调用 GET /v1/video/generations/{id} 获取实时进展

🔄

↓

步骤 5

获取并下载超分视频成果

任务成功（completed）后，从 metadata.url 获取成果链接

🎬

6. 创建视频超分任务

6.1 请求说明

请求方式：POST

完整请求地址：https://api.ecidc.net/v1/video/generations

鉴权方式：在 HTTP Header 中携带 API Key。

6.2 请求 Header

Header	必填	说明
`Authorization`	是	格式为 `Bearer sk-xxxxxx`
`Content-Type`	是	固定为 `application/json`

6.3 公共请求参数

参数名称	数据类型	是否必填	说明
model	string	是	三选一： • `volc-mediakit-enhance-video` 标准版 • `volc-mediakit-enhance-video-professional` 专业版 • `volc-mediakit-enhance-video-generative` 大模型版
prompt	string	否	建议传 `video_enhance`；不填时网关会自动补上
metadata	object	是	扩展参数，见各版本子表。仅 `video_url` 必填

6.3.1 标准版 `metadata`

参数名称	数据类型	是否必填	说明
`video_url`	string	是	待超分视频的公网下载链接
`scene`	string	否	仅标准版。`aigc` / `short_series` / `ugc` / `old_film` / `common`。不填默认 `aigc`
`resolution`	string	否	`720p` / `1080p` / `2k` / `4k`。不填默认 `1080p`。与 `resolution_limit` 互斥
`resolution_limit`	integer	否	输出边长上限（像素）。与 `resolution` 不可同时传
`fps`	integer	否	目标帧率，最高 120。不填保持原片帧率
`bitrate_level`	string	否	`low` / `medium` / `high`

6.3.2 专业版 `metadata`

参数名称	数据类型	是否必填	说明
`video_url`	string	是	待超分视频的公网下载链接
`resolution`	string	否	如 `720p` / `1080p` / `2k` / `4k` / `8k`。与 `resolution_limit` 互斥
`resolution_limit`	integer	否	输出边长上限。与 `resolution` 不可同时传
`fps`	integer	否	目标帧率，最高 120。不填保持原片帧率
`bitrate_level`	string	否	`low` / `medium` / `high`
`queue_id`	string	否	可选队列 ID
`client_token`	string	否	幂等令牌
`callback_args`	string	否	回调透传参数

专业版不要传 scene，传了会返回 400。

6.3.3 大模型版 `metadata`

参数名称	数据类型	是否必填	说明
`video_url`	string	是	待增强视频链接。输入最高 1080p（短边 360–1080，长边 360–1920），仅支持 SDR
`resolution`	string	否	仅 `720p`（上游默认）/ `1080p` / `2k`。不支持 `4k`
`fps`	integer	否	目标帧率，最高 120。不填保持原片帧率；建议不超过原片 4 倍
`bitrate_level`	string	否	`low` / `medium`（默认）/ `high`。与 `bitrate` 同时传时上游只认 `bitrate`
`bitrate`	integer	否	精确码率，单位 kbps，范围 `[10, 150000]`
`client_token`	string	否	幂等令牌
`callback_args`	string	否	回调透传参数

大模型版不要传 scene、resolution_limit、tool_version。

6.4 请求示例 (cURL)

标准版

专业版

大模型版（480p 升 1080p）

6.5 创建返回示例

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "volc-mediakit-enhance-video-generative",
  "status": "queued",
  "progress": 0,
  "created_at": 1770405483,
  "seconds": "60"
}

6.6 创建返回字段说明

字段	类型	说明
`id`	string	任务 ID，后续查询的唯一凭证
`object`	string	固定为 `video.generation.job`
`model`	string	本次使用的模型名称
`status`	string	此时一般为 `queued`
`progress`	integer	当前进度百分比，此时为 `0`
`created_at`	integer	创建时间 Unix 时间戳
`seconds`	string	预扣所用的估算时长（秒）

7. 查询任务结果

7.1 请求说明

请求方式：GET

完整请求地址：https://api.ecidc.net/v1/video/generations/{task_id}

7.2 请求示例 (cURL)

7.3 查询返回示例

7.3.1 处理中 (in_progress)

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "volc-mediakit-enhance-video-generative",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1770405483
}

7.3.2 处理成功 (completed)

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "volc-mediakit-enhance-video-generative",
  "status": "completed",
  "progress": 100,
  "created_at": 1770405483,
  "completed_at": 1770405883,
  "metadata": {
    "url": "https://example.com/output_enhanced.mp4",
    "duration": 7.083,
    "resolution": "1920x1080",
    "fps": 30
  }
}

7.3.3 处理失败 (failed)

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "volc-mediakit-enhance-video-generative",
  "status": "failed",
  "progress": 0,
  "created_at": 1770405483,
  "error": {
    "code": "VIDEO_SUPER_RESOLUTION_FAILED",
    "message": "video super resolution task failed"
  }
}

7.4 任务状态生命周期说明

状态值	说明
`queued`	已提交，排队等待调度
`in_progress`	执行中，`progress` 为 0–99
`completed`	成功，从 `metadata.url` 获取结果
`failed`	失败，见 `error`

大模型版处理较重，平均 RTF 约 15–20（1 分钟原片大约需要 15–20 分钟）。请把轮询间隔设为 10 秒或更长，避免过于频繁。

8. 输入与输出规范

8.1 输入视频规格约束

限制项	标准版 / 专业版	大模型版
视频地址	公网可下载 HTTP/HTTPS，处理期间须保持可访问	同左
视频格式	MP4、MOV、MKV、AVI、FLV、WebM 等	同左
输入分辨率	按上游规格	最高 1080p；短边 360–1080，长边 360–1920
色彩空间	—	仅支持 SDR
文件大小	建议不超过 10GB	建议不超过 10GB
音频	默认保留原音轨并回封装	同左

8.2 输出视频规格

封装：默认 MP4

分辨率：对齐请求中的 metadata.resolution（不填时：标准版默认 1080p，大模型版上游默认 720p）

帧率：传入 fps 则插帧到该值；不传则保持原片帧率

9. 推荐配置与最佳实践

9.1 标准版：AIGC 720P 升 1080P + 插帧 60fps

{
  "model": "volc-mediakit-enhance-video",
  "prompt": "video_enhance",
  "metadata": {
    "video_url": "https://example.com/aigc_input.mp4",
    "scene": "aigc",
    "resolution": "1080p",
    "fps": 60
  }
}

9.2 专业版：1080P 高码率

{
  "model": "volc-mediakit-enhance-video-professional",
  "prompt": "video_enhance",
  "metadata": {
    "video_url": "https://example.com/input.mp4",
    "resolution": "1080p",
    "fps": 30,
    "bitrate_level": "high"
  }
}

9.3 大模型版：480p 生成后再增强至 1080p（推荐）

{
  "model": "volc-mediakit-enhance-video-generative",
  "prompt": "video_enhance",
  "metadata": {
    "video_url": "https://example.com/480p.mp4",
    "resolution": "1080p"
  }
}

升到 2K 并指定 60fps、精确码率：

{
  "model": "volc-mediakit-enhance-video-generative",
  "prompt": "video_enhance",
  "metadata": {
    "video_url": "https://example.com/480p.mp4",
    "resolution": "2k",
    "fps": 60,
    "bitrate": 8000
  }
}

9.4 SDK 调用示例

JavaScript

Python

10. 错误码说明

错误码	说明
`40001`	请求参数错误，请核对 JSON 与必填字段
`40002`	`video_url` 为空或不合法
`40003`	视频下载失败，请确认公网可访问且无防盗链
`40004`	视频编码或音轨结构不支持
`40005`	`resolution` 超出该版本允许范围（例如大模型版传了 `4k`）
`40007`	视频体积超过建议上限
`40100`	鉴权失败，检查 `Authorization`
`40300`	API Key 未开通对应模型（三个版本需分别授权）
`40400`	任务 ID 不存在
`50000`	网关或上游内部故障
`50001`	上游超分渲染出错

常见本地拦截（HTTP 400）：

专业版 / 大模型版传入 scene

resolution 与 resolution_limit 同时传入

大模型版传入 resolution_limit、tool_version，或 resolution 不是 720p / 1080p / 2k

11. 常见问题 (FAQ)

[!NOTE]
Q：超分是同步还是异步？
A：完全异步。提交后立即返回任务 id，再以 5–10 秒间隔（大模型版建议 ≥10 秒）查询，直到 completed 或 failed。

[!IMPORTANT]
Q：音频会丢失吗？
A：不会。系统会保留原音轨，画面处理完成后无损回封装。

[!TIP]
Q：三个版本怎么选？
A：
常规超分、需要 scene 模板 → 标准版
更高画质、最高到 8K → 专业版
AIGC 先出 480p 再拉到 1080p/2K、要语义补全细节 → 大模型版

[!WARNING]
Q：专业版和大模型版可以传 scene 吗？
A：不可以，网关会直接 400。scene 只属于标准版。

积度探索视频超分介绍文档

积度探索 API 系统 · 视频超分服务介绍#

1. 能力概述#

1.1 版本怎么选#

2. 核心能力#

3. 适用场景#

4. 计费说明#

4.1 每秒基准单价（720P ≤30fps）#

4.2 标准版系数#

4.3 专业版 / 大模型版系数#

5. 推荐接入流程#

6. 创建视频超分任务#

6.1 请求说明#

6.2 请求 Header#

6.3 公共请求参数#

6.3.1 标准版 metadata#

6.3.2 专业版 metadata#

6.3.3 大模型版 metadata#

6.4 请求示例 (cURL)#

标准版#

专业版#

大模型版（480p 升 1080p）#

6.5 创建返回示例#

6.6 创建返回字段说明#

7. 查询任务结果#

7.1 请求说明#

7.2 请求示例 (cURL)#

7.3 查询返回示例#

7.3.1 处理中 (in_progress)#

7.3.2 处理成功 (completed)#

7.3.3 处理失败 (failed)#

7.4 任务状态生命周期说明#

8. 输入与输出规范#

8.1 输入视频规格约束#

8.2 输出视频规格#

9. 推荐配置与最佳实践#

9.1 标准版：AIGC 720P 升 1080P + 插帧 60fps#

9.2 专业版：1080P 高码率#

9.3 大模型版：480p 生成后再增强至 1080p（推荐）#

9.4 SDK 调用示例#

JavaScript#

Python#

10. 错误码说明#

11. 常见问题 (FAQ)#