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

适用产品

🚀 积度探索 AI

能力类型

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

参考接口

🔌 提交任务 /v1/video/generations

1. 能力概述

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

积度探索 API 系统将视频解码、超分增强算法、智能降噪、智能插帧（最高支持 120fps）、色彩还原和高并发异步任务队列深度整合，封装为高可用的统一接口。用户仅需提交公网可访问的视频 URL，系统可返回清晰度与画质显著提升的高分辨率视频。

2. 核心能力

🎬视频超分

将低分辨率视频提升至 720P、1080P、2K 或 4K，最高支持 4K 规格分发。

⚡智能插帧

通过帧率插值技术（最高支持 120fps），使高速运动的画面更丝滑自然，告别卡顿感。

🔍细节增强

针对性增强人物面部、服饰、物体纹理、背景风景等画面局部的细节表现力。

✨清晰度提升

改善因对焦模糊、低清拍摄、网络压缩等历史链路导致的画质模糊与下降问题。

🤫智能降噪

自适应压制或清除视频噪点、压缩马赛克块、色带、蚊噪等伪影，还原平滑纯净画质。

🎨色彩优化

自适应调整亮度、对比度与色彩饱和度，加深动态范围，使色彩表现更饱满通透。

3. 适用场景

🤖AIGC 视频超分：对 AI 视频生成模型产出的低分辨率/低帧率视频进行超分与插帧，消除因生成带来的边缘抖动与噪点，提升商业成片率。

🎬短剧超清化：针对竖屏微短剧，深度增强人物面部及服化道纹理，满足现代主流移动端设备的高清甚至 2K/4K 观影诉求。

📱短视频平台优化：消除社交平台二次传输压缩造成的块效应与清晰度劣化，为用户提供更好的观感和点击意愿。

🎥老旧媒资修复：将早期的低帧率、低清历史影片或 DV 素材进行细节重建、智能插帧（如插帧至 60fps/120fps），重焕光彩。

4. 计费换算系数

视频超分服务按输出分辨率与**输出帧率（即 FPS）**的系数进行计费扣减，最终换算系数为两者乘积：

4.1 维度系数表

分辨率系数 (Resolution Factor)

720P (1280x720) 及以下	1.0
1080P (1920x1080) 及以下	2.0
2K (2560x1440) 及以下	4.0
4K (3840x2160) 及以下	8.0

帧率系数 (FPS Factor)

普通帧率 (≤ 30fps)	1.0
高帧率 (> 30fps)	2.0

4.2 综合换算系数速查表

输出分辨率规格	输出帧率范围 (FPS)	最终计费系数
720P (1280x720) 及以下	≤ 30fps	1
720P (1280x720) 及以下	> 30fps	2
1080P (1920x1080) 及以下	≤ 30fps	2
1080P (1920x1080) 及以下	> 30fps	4
2K (2560x1440) 及以下	≤ 30fps	4
2K (2560x1440) 及以下	> 30fps	8
4K (3840x2160) 及以下	≤ 30fps	8
4K (3840x2160) 及以下	> 30fps	16

5. 推荐接入流程

步骤 1

准备视频公网 URL

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

📂

↓

步骤 2

提交视频超分任务

向网关发送 POST /v1/video/generations 请求提交超分配置

🔌

↓

步骤 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` (您的 API 密钥)
`Content-Type`	是	固定为 `application/json`

6.3 请求参数

参数名称	数据类型	是否必填	参数功能与取值范围说明
model	string	是	模型 ID。统一指定为 `volc-mediakit-enhance-video`
prompt	string	是	文本描述提示词。画质增强默认可传 `video_enhance`
metadata	object	是	扩展核心参数字典（详细子参数见下表）

`metadata` 子参数

参数名称	数据类型	是否必填	说明
`video_url`	string	是	需要超分的视频公网下载链接
`scene`	string	是	超分业务场景分类。可选范围： • `aigc`：AIGC 场景（AI 生成视频的画面修复） • `short_series`：短剧场景（人像与细节修饰） • `ugc`：UGC 短视频场景（常规短视频画质拉伸） • `old_film`：老旧影片场景（经典老片划痕修复与高清重制）
`resolution`	string	是	预设目标分辨率。可选范围：`720p`、`1080p`、`2k`、`4k`（最高支持对齐至 4K 分辨率）
`fps`	string	是	目标帧率（最高支持 120fps）。在智能插帧时，系统将依此进行运算平滑（例如 `"50"`、`"60"` 等）

6.4 请求示例 (cURL)

6.5 创建返回示例

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

6.6 创建返回字段说明

字段	类型	说明
`id`	string	任务 ID，后续查询的唯一凭证
`object`	string	任务类型标识，固定为 `video.generation.job`
`model`	string	使用的模型名称
`status`	string	当前任务状态，此时固定为 `queued`（排队中）
`progress`	integer	当前处理进度百分比，此时为 `0`
`created_at`	integer	任务创建时的 Unix 时间戳
`seconds`	string	视频估算或设定时长字符数（例如 `"12"`）

7. 查询任务结果

7.1 请求说明

请求方式：GET

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

7.2 请求示例 (cURL)

7.3 查询返回示例

7.3.1 处理中 (in_progress)

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

7.3.2 处理成功 (completed)

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

7.3.3 处理失败 (failed)

{
  "id": "gen_20260608123456789",
  "object": "video.generation.job",
  "model": "volc-mediakit-enhance-video",
  "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` 对象排查失败代码与原因

8. 输入与输出规范

8.1 输入视频规格约束

限制项	约束说明
视频地址	必须为公网可下载链接，处理链路期间该链接须保持存活及可用
视频格式	支持 MP4, MOV, MKV, AVI, FLV, WebM 等主流封装格式
视频大小	单个文件建议控制在 10GB 以内
视频时长	建议视频总时长在 2 小时以内
音频保留	系统默认会完整拉取并复制原始音轨，在处理完成后完美回填封装，保障音质零损耗

8.2 输出视频规格

视频格式：输出默认打包为高兼容性的 MP4 格式。

输出帧率：根据传入的 metadata.fps 参数自动升帧/插帧。

输出分辨率：严格对齐您设定的 metadata.resolution。

9. 推荐配置与最佳实践

9.1 场景化推荐配置

9.1.1 720P AIGC 视频超分至 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.1.2 经典低帧率老旧影片至 2K + 插帧至 50fps 深度修复

{
  "model": "volc-mediakit-enhance-video",
  "prompt": "video_enhance",
  "metadata": {
    "video_url": "https://example.com/old_film_input.mp4",
    "scene": "old_film",
    "resolution": "2k",
    "fps": "50"
  }
}

9.2 SDK 调用示例

9.2.1 JavaScript 示例

9.2.2 Python 示例

10. 错误码说明

错误码	错误分类说明
`40001`	请求参数错误，请核对 JSON 格式与必需字段
`40002`	`video_url` 参数为空或不合法，系统无法识别
`40003`	视频文件下载失败，请确保公网稳定且没有防盗链限制
`40004`	视频编码格式或音轨结构不支持
`40005`	`resolution` 规格超出平台配额限制
`40007`	视频文件体积超过 10GB 限制
`40100`	鉴权失败，请检查请求 Header 中 `Authorization` 的 Token 格式
`40300`	您的 API Key 尚未开通 `volc-mediakit-enhance-video` 渠道模型授权
`40400`	所查询的任务 ID 不存在
`50000`	网关或超分渲染服务内部故障
`50001`	上游算法算力节点超分渲染出错

11. 常见问题 (FAQ)

[!NOTE]
Q：超分处理是同步还是异步的？
A：视频超分与插帧耗费极大算力，采用完全异步化的设计。提交请求后，系统会立即返回任务 id；随后需要以合理频率（例如 5~10 秒/次）发起 GET 查询直至任务状态变更为 completed 或 failed。

[!IMPORTANT]
Q：音频轨道在超分后会丢失或受损吗？
A：完全不会。系统在解析输入视频时会分离出音频流，待视频画面帧超分/插帧平滑重组完毕后，会利用封装器以无损直通的方式将原音轨缝合打包，确保最终输出视频的声音效果原汁原味。

[!TIP]
Q：如何选择合理的输出帧率与分辨率配置？
A：对于以手机录屏、课件为主的 UGC 视频，通常输出 1080p 与 30 帧即能获得绝佳感官，且消耗额度较低；而对于大型影视场景、动漫、AI 创意视频，配置 2k/4k 配合 60/120 帧能使运动物体与主体线条展现极具质感的平稳柔顺性。

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

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

1. 能力概述#

2. 核心能力#

3. 适用场景#

4. 计费换算系数#

4.1 维度系数表#

4.2 综合换算系数速查表#

5. 推荐接入流程#

6. 创建视频超分任务#

6.1 请求说明#

6.2 请求 Header#

6.3 请求参数#

metadata 子参数#

6.4 请求示例 (cURL)#

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 场景化推荐配置#

9.1.1 720P AIGC 视频超分至 1080P + 智能插帧至 60fps#

9.1.2 经典低帧率老旧影片至 2K + 插帧至 50fps 深度修复#

9.2 SDK 调用示例#

9.2.1 JavaScript 示例#

9.2.2 Python 示例#

10. 错误码说明#

11. 常见问题 (FAQ)#