本文为您详细介绍如何调用 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。您需要在调用本接口前，通过任一方式将视频上传至点播空间，并获取其 Vid。

注意

您必须设置 Vid 或 DirectUrl参数之一，但不能同时设置这两个参数。

DirectUrl Object 可选示例值：-

通过 DirectUrl 模式指定待处理视频的信息。您需要在调用本接口前，通过任一方式将视频上传至点播空间，并获取其相关信息。

注意

您必须设置 Vid 或 DirectUrl参数之一，但不能同时设置这两个参数。

SpaceName String 必选示例值：test

空间名称。可调用 ListSpace 获取当前账号下所有空间的信息。

FileName String 必选示例值：example.mp4

文件路径。音视频上传至视频点播服务后，您可通过媒资上传完成事件获取 FileName。

BucketName String 可选示例值：tos-cn-v-cd3a11

存储桶名称。可调用 ListSpace 获取空间所绑定的存储桶名称。

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

自定义字段，将在媒体处理任务执行完成事件中透传返回。字段长度最大为 512 字节。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

RunId String 示例值：hb:c5cacd4946bd***a5fd9f74159b03ae8

媒体处理任务执行 ID。

请求示例

通过 Vid 提交场景式画质增强任务，使用 short_series（短剧）场景模板。

错误码

本接口无特有的错误码。更多信息请见公共错误码。

服务端 SDK

视频点播为 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API。本接口仅 VOD SDK 2.0 支持，详见 V2.0 SDK 介绍与迁移说明。