视频点播
视频点播
服务端 API 参考
请输入
- 文档首页
视频点播视频 AI 应用StartExecution - 提交媒体处理任务提交场景式画质增强任务
复制全文
下载 pdf提交场景式画质增强任务
文档反馈
问问助手本文为您详细介绍如何调用 StartExecution 接口提交异步的画质增强任务，可指定 aigc、short_series（短剧）、ugc、old_film（老片修复）等业务场景，系统将智能匹配最优处理策略。详细功能介绍和使用流程请见场景式画质增强。
注意事项
- 调用准备：在调用本接口前，建议您先阅读如何调用 OpenAPI 文档，以了解 OpenAPI 的通用调用流程，包括在线调试、获取 curl 命令、请求签名等基础操作。
- 计费说明：提交任务会产生视频 AI 费用，具体参见视频 AI 应用计费。
- QPS 限制：本接口的单用户 QPS 限制为 50 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
请求说明
- 请求方式：POST
- 请求地址：https://vod.volcengineapi.com?Action=StartExecution&Version=2025-01-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：StartExecution
接口名称。当前 API 的名称为 StartExecution。
Version String 必选 示例值：2025-01-01
接口版本。当前 API 的版本为 2025-01-01。
Body
Input Object 可选 示例值：-
输入文件信息。
Type String 必选 示例值：Vid
输入文件类型。取值如下：
- Vid：Vid 模式。此模式下，您还需设置 Vid 参数。
- DirectUrl：DirectUrl 模式。此模式下，您还需设置 DirectUrl 参数。
Vid String 可选 示例值：v0ccfeg7007acsg***fog65ubr7niqng
注意
您必须设置 Vid 或 DirectUrl参数之一，但不能同时设置这两个参数。
DirectUrl Object 可选 示例值：-
注意
您必须设置 Vid 或 DirectUrl参数之一，但不能同时设置这两个参数。
SpaceName String 必选 示例值：test
FileName String 必选 示例值：example.mp4
BucketName String 可选 示例值：tos-cn-v-cd3a11
Operation Object 必选 示例值：-
媒体处理操作配置。
Type String 必选 示例值：Task
处理类型。取值如下：
- Task：单任务。
Task Object 可选 示例值：-
单任务配置。当 Type 为 Task 时需要设置此参数。
Type String 必选 示例值：Enhance
任务类型：
- Enhance: 画质增强任务。
Enhance Object 可选 示例值：-
画质增强任务配置。当 Type 为 Enhance 时需要设置此参数。
Type String 可选 示例值：Moe
增强模型类型。默认为 Custom。
- Custom: 自定义增强模型。您需要通过 Modules 参数，手动组合一个或多个独立的增强算子（如超分、插帧等）。
- Moe:（推荐）场景化增强模型。您需要通过 MoeEnhance 参数选择一个针对特定场景（如短剧、AIGC 等）的预设模板，系统会自动应用最优的算子组合。
Modules Object[] 可选 示例值：-
自定义增强算子列表。当 Type 为 Custom 时，此参数为必填，用于配置一个或多个独立的增强模块。
Type String 必选 示例值：SR
自定义增强的算子类型。支持的取值如下：
- SR：智能超分
- AudioDenoise：音频降噪
- SDR2HDR：SDR 转 HDR
- VFI：智能插帧
- SDREnhance：SDR 增强
MoeEnhance Object 可选 示例值：-
场景化增强配置。当 Type 为 Moe 时，此参数为必填。
Config String 必选 示例值：common
场景化模板类型。用于选择一个针对特定业务场景的预设画质增强模板。支持的取值如下：
- common: 通用模板
- ugc: UGC 短视频
- short_series: 短剧
- aigc: AIGC 内容
- old_film: 老片修复
Target Object 可选 示例值：-
输出视频配置。用于指定输出视频的分辨率、帧率、目标码率和色深等参数。如果不传，系统将默认保持与源视频一致。
Res String 可选 示例值：1080p
目标分辨率。支持的取值如下所示。
- 240p
- 360p
- 480p
- 540p
- 720p
- 1080p
- 2k
- 4k
- 6k
- 8k
注意
此参数与 resolution_limit 互斥，不可同时配置。
ResLimit Integer 可选 示例值：1080
指定输出视频的短边像素值，取值范围为 [128, 4320]。设置后，系统将锁定视频的短边像素值为设定值，并在保持原视频宽高比的前提下，等比缩放至该限制值。示例：若原视频为 640x480 (4:3)，设置 resolution_limit 为 720，则输出视频的短边将提升至 720，宽度等比缩放至 960。
注意
此参数与 resolution 互斥，不可同时配置。
Fps Float 可选 示例值：30
目标帧率，单位为 fps。若未指定 fps 参数，输出视频将保持与原始片源一致的帧率。取值范围为 (0, 120]。建议不超过原片的 4 倍。
Bitrate Integer 可选 示例值：2000
设置输出视频的目标平均码率。该参数将决定视频的视觉质量和最终的文件体积。取值范围为 [10, 50000]，单位 Kbps。为确保不同场景下的画质稳定性，系统会根据视频内容的复杂度进行动态调整。实际输出码率将在您设定目标的 0.8 倍至 1.5 倍之间波动。请参考不同输出分辨率的推荐码率表进行设置。
BitDepth Integer 可选 示例值：10
输出视频的色深。仅专业版画质增强支持该参数。支持的取值为 8、10、12、16，默认值为 8。设置为 10 或 12 时，输出视频采用 H.265 编码。设置为 16 时，输出视频采用 FFV1 无损格式编码。更多信息，请参见色深。
VideoStrategy Object 必选 示例值：-
视频增强策略。用于控制视频增强的类型和强度。
EnhanceLevel String 必选 示例值：Pro
画质增强档位，支持的取值如下：
- Fast：极速版。集成基础超分和基础增强能力，兼顾处理速度与画面清晰度。
- Standard：标准版。采用自适应算法，在画面质感与处理速度之间取得更优平衡。
- Pro：专业版。基于大模型修复，提供影视级画质，处理耗时较长。
说明
RepairStrength Integer 可选 示例值：0
视频增强强度。仅标准版和专业版支持此参数，极速版不支持。支持的取值如下：
- -50：自然版。采用更柔和的增强效果，使画面质感更接近源视频。在部分场景（例如 AI 生成的拟人视频）中，可以帮助减少油画感。
- 0：高清版（默认）。采用更锐利的增强效果。
Control Object 可选 示例值：-
任务控制配置。
ClientToken String 可选 示例值：QqS3o5L4BLFCDxGZ&b
用户请求凭证，用于区分不同请求。大小写敏感，不超过 64 个 ASCII 码可打印字符。默认情况下，视频点播转码服务在接收到触发工作流请求后，会执行幂等行为。这意味着，如果判定当前请求与之前发送的请求相同，则不会重复执行该请求。关于幂等行为、目的和条件，请参考工作流幂等说明。若您希望跳过幂等行为，例如修改了某一工作流所绑定的媒体处理模板中的配置，想要对同一个 Vid 重新执行相同的工作流，则可以设置此参数。
CallbackArgs String 可选 示例值：Example
返回参数
RunId String 示例值：hb:c5cacd4946bd***a5fd9f74159b03ae8
媒体处理任务执行 ID。
请求示例
通过 Vid 提交场景式画质增强任务，使用 short_series（短剧）场景模板。
错误码
服务端 SDK
视频点播为 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API。本接口仅 VOD SDK 2.0 支持，详见 V2.0 SDK 介绍与迁移说明。
最近更新时间：2026.10.21 13:17:50
这个页面对您有帮助吗？
有用
有用
无用
无用