本文为您介绍如何提交场景式画质增强任务，指定视频处理场景和参数，并获取任务执行结果。

前提条件 #

• 已注册火山引擎账号并完成实名认证。
• 已开通视频点播服务并创建空间。
• 将待处理的视频文件上传至点播空间，并获取对应的 Vid（视频 ID） 或 FileName（文件路径）。

提交画质增强任务 #

提交方式概览 #

视频点播提供多种方式来实现画质增强，您可以根据业务需求选择最适合的一种。

方式 1：通过预设模板（单模板） #

此路径适合需要对大量视频执行标准化画质增强流程的场景。

1. 在控制台创建画质增强模板：
   1. 登录视频点播控制台。
   2. 单击左侧导航栏媒体处理 > 媒体处理模板。
   3. 在画质增强修复模板页签下，单击创建画质增强修复模板按钮。根据您的业务需求选择一个场景化模板（如“短剧”），并完成相关配置。

      说明

      具体操作和参数说明，请见画质增强修复模板。

   4. 保存模板，并记录下模板 ID。
2. 应用模板并触发任务：模板创建完成后，您可以通过以下方式应用该模板来处理您的视频。

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2025-01-01
{
    "Input": {
        "Type": "Vid",
        "Vid": "your_video_vid"
    },
    "Operation": {
        "Type": "Template",
        "Template": {
            "Type": "Enhance",
            "Enhance": {
                "TemplateId": "your_enhance_template_id" // 填入您在步骤 1 创建的模板 ID
            }
        }
    }
}

方式 2：通过 API 动态配置（单任务） #

此方式无需在火山引擎控制台预先创建模板，所有画质增强的参数都在 API 调用时动态传入。您可调用 StartExecution 接口，并将 Operation.Type 设置为 Task，在 Operation.Task.Enhance 对象中传入具体的画质增强配置。核心请求参数说明如下：

• Input: 指定待处理的视频文件。
• Operation.Task.Type: 必须设置为 Enhance。
• Operation.Task.Enhance: 在此对象中动态定义所有画质增强参数。
  • Type: 设置为 Moe，表示使用场景化增强模型。
  • MoeEnhance:
    • Config: 指定一个场景化预设模板，如 aigc, short_series, ugc, old_film, common。
    • Target: 动态指定输出视频的分辨率 Res、帧率 Fps、目标码率 Bitrate 和色深 BitDepth 等输出配置。BitDepth 仅专业版支持，可取 8、10、12、16，默认值为 8。设置为 10 或 12 时，输出视频采用 H.265 编码。设置为 16 时，输出视频采用 FFV1 无损格式编码。
    • VideoStrategy:
      • EnhanceLevel: 指定画质增强档位，支持 Fast、Standard 和 Pro。
      • RepairStrength: 指定画质增强强度。

请求示例：使用专业版将 AI 生成的视频增强至 4K、10 bit

以下示例展示了如何为一个 AIGC 类型的视频，动态应用 aigc 场景化模板，并将其增强至 4k、10 bit。

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2025-01-01
{
    "Input": {
        "Type": "Vid",
        "Vid": "your_aigc_video_vid"
    },
    "Operation": {
        "Type": "Task",
        "Task": {
            "Type": "Enhance",
            "Enhance": {
                "Type": "Moe",
                "MoeEnhance": {
                    "Config": "aigc",
                    "Target": {
                        "Res": "4k",
                        "Bitrate": 8000,
                        "BitDepth": 10
                    },
                    "VideoStrategy": {
                        "RepairStrength": 0,
                        "EnhanceLevel": "Pro"
                    }
                }
            }
        }
    }
}

成功提交后，您将从响应中获得任务的唯一标识 RunId。

获取任务结果 #

获取方式概览 #

画质增强任务提交后，系统将在后台进行异步处理。获取结果的方式取决于您提交任务的入口：

方式 1：调用 API 查询或配置事件通知 #

任务由 StartExecution 接口触发

当您通过 StartExecution 接口提交一个单模板任务或单任务时，通过以下两种方式获取结果：

• 主动查询：轮询 GetExecution 接口，并传入 RunId 来查询任务的执行状态和具体结果。
• 事件通知（回调） ：配置媒体处理任务执行完成事件。任务完成后，您配置的服务端将收到包含结果的回调。

您需要根据提交任务时 Operation.Type 的值，在 Output 对象中找到对应的结果。

• 对于单模板任务 (Operation.Type: Template)，产物信息路径为 Output.Template.Enhance。
• 对于单任务 (Operation.Type: Task)，产物信息路径为 Output.Task.Enhance。

无论通过哪种路径，最终您都会得到一个 TranscodeInfo 对象，其中包含了画质增强后视频的所有详细信息。其中，您需要关注 StoreUri 字段。StoreUri 本身不能直接播放，后续可用于拼接产物视频 URL。

任务由 StartWorkflow 接口触发

当您通过 StartWorkflow 接口提交一个包含画质增强节点的工作流任务时，通过以下两种方式获取结果：

• 主动查询：轮询 GetWorkflowExecutionResult 接口，并传入 RunId 来查询任务的执行状态和具体结果。
• 事件通知（回调） ：配置工作流执行完成事件。工作流完成后，您将收到包含所有节点结果的回调。

方式 2：在控制台查看 #

当您在视频点播控制台媒资管理页面手动触发画质增强任务时，可直接在控制台查看任务结果。

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏媒体处理 > 媒体处理任务，查看媒体处理任务状态。
3. 状态为成功后，单击查看详情按钮。
4. 在媒体处理任务详情页面，单击查看产物按钮。
5. 单击视频地址页签，查看画质增强结果的相关信息。
   

后续操作 #

拼接产物视频 URL #

获取到画质增强后视频的 StoreUri 后，您需要通过自行拼接的方式将其转换为公网可访问的 URL，以便于播放或下载。拼接方式如下：

1. 从 StoreUri 中解析出 FileName：StoreUri 由 BucketName 和 FileName 组成。假设您获取到的 StoreUri 为 tos-vod-v-9fbcde4037780626/video.mp4，则 BucketName 为 tos-vod-v-9fbcde4037780626，FileName 为 video.mp4。
2. 根据规则拼接出播放地址。一个基础的访问 URL 由以下部分组成：[Protocol]://[PlaybackDomain]/[FileName]
   • [Protocol]：通常为 https 或 http。取决于您是否配置 SSL 证书。
   • [PlaybackDomain]：您在点播控制台配置的加速域名。
   • [FileName]：您从 StoreUri 中解析出的 FileName。
     拼接示例：假设您的加速域名为 play.example.com，获取到的 FileName 为 video.mp4，那么拼接后的基础 URL 为：https://play.example.com/video.mp4

常见问题 #

Q：画质增强任务失败怎么办？

A：检查使用的画质增强模板版本，如您使用的是自定义增强（旧版），建议创建新的场景式画质增强模板，然后重新提交任务。