概述
计费说明
说明：
接入前置操作
在使用本功能前，您需完成以下前置操作：
腾讯云账号注册/登录，登录 MPS 控制台开通 MPS 产品、完成服务角色授权。具体请参考 快速入门。
若您使用腾讯云子账号，还需要保证账号有足够权限使用 MPS 产品。具体请参考 账号授权相关。
发起 AI 解说二创任务
概述
使用 AI 解说二创功能，需要使用媒体处理 “智能分析”下的35号预设模板，并额外传入
ExtendedParameter扩展参数来实现自定义调参。方式1：控制台发起任务
1. 进入控制台 创建任务 页面，依次选择输入文件路径、配置编排处理流程、输出路径。
2. 在编排配置中，选择媒体 AI - 智能分析节点。
3. 在右侧弹出页面中，选择35号预设模板。开启“更多设置 - 扩展参数”，根据下文 扩展参数说明，传入所需参数。
说明：
发起 AI 解说二创任务，扩展参数必传，否则任务会失败。
MPS 控制台会自动转义，请直接传入 JSON 数据，不要传入转义后的字符串，否则任务会失败。
方式2：API 发起任务
调用 ProcessMedia 接口 ，选择 AiAnalysisTask 任务，将
Definition 设置为35（预设模板 ID），ExtendedParameter 填写扩展参数，通过该参数实现 AI 解说二创能力，取值见下文 扩展参数说明。ProcessMedia 调用 JSON 示例如下：{"InputInfo":{ //输入视频路径，请替换为您的原始视频"Type":"URL","UrlInputInfo":{"Url":"https://test-1234567.cos.ap-nanjing.myqcloud.com/mps_test/myvideo.mp4"}},"OutputStorage":{ //输出COS存储桶，请替换"Type":"COS","CosOutputStorage":{"Bucket":"test","Region":"ap-nanjing"}},"OutputDir":"/mps_test/output/",//输出文件夹路径，请替换"AiAnalysisTask":{"Definition":35, //预设模板ID，填 35 即可"ExtendedParameter":"{\\"reel\\":{\\"processType\\":\\"narrate\\",\\"narrateParam\\":{\\"onlyNarration\\":1}}}" //扩展参数，必传，用于指定是否拼接高光集锦片段、指定解说字幕样式等},"TaskNotifyConfig":{ //事件回调通知配置，可选"NotifyType":"URL","NotifyUrl":"http://www.qq.com/callback"}}
建议您通过 API Explorer 实现快速验证。您可以将上述 JSON （需去除备注文案）复制到 API Explorer 的 JSON 模式中，再切换至“表单”模式可以自动解析。调整输入输出路径等必要参数后，单击发起调用即可。
ExtendedParameter 扩展参数说明
示例：
{"reel": {"processType": "narrate","narrateParam": {"onlyNarration": 1},"extendData": [{"url": "https://website.com/input/ep2.mp4"}, {"url": "https://website.com/input/ep3.mp4"}, {"url": "https://website.com/input/ep4.mp4"}]}}
参数 | 类型 | 必填 | 说明 |
processType | string | 是 | 传入 "narrate" 即可。 |
narrateParam | object | 否 | |
subtitleParam | object | 否 | |
outputLanguage | string | 否 | 支持 "zh"、"en"，默认为"zh"。"zh"：简体中文。"en"：英语。 |
narrateParam
参数 | 类型 | 必填 | 说明 |
onlyNarration | int | 否 | 0：表示在解说中间拼接高光集锦片段。 1：表示生成纯解说视频，不拼接集锦片段。 默认为0。 |
extendData | array | 否 | 扩展数据，若输入原始视频多于 1 个，可使用该字段传入额外输入视频 URL。 |
extendData[i].url | string | 否 | 额外输入视频 URL。 |
subtitleParam
参数 | 类型 | 必填 | 说明 |
style | object | 否 |
查看任务结果
控制台查询结果
1. 您可以在控制台 任务管理 页面查看任务状态，当子任务状态为“成功”时，单击回调 JSON，可以在输出信息中找到输出文件路径。
2. 如果使用 COS 作为输出路径，您可以在 MPS 控制台的编排管理 > COS Bucket > 输出 Bucket 页面中找到输出文件。文件名以
reel 开头的即为输出的 AI 解说视频文件。
事件通知回调
在使用 ProcessMedia 发起媒体处理任务时，您可以通过 TaskNotifyConfig 参数配置事件回调。当任务处理完成后，会通过配置的回调信息回调任务结果，您可以通过 ParseNotification 解析事件通知结果。下方列出了 相关数据结构 以供参考。
调用接口查询任务结果
在使用 ProcessMedia 发起媒体处理任务后，会返回任务 ID（TaskId），例如：
24000022-WorkflowTask-b20a8exxxxxxx1tt110253、24000022-ScheduleTask-774f101xxxxxxx1tt110253。调用 DescribeTaskDetail 接口，输入任务 ID 即可获取任务结果，您需要解析
WorkflowTask/ScheduleTask -> AiAnalysisResultSet > ReelTask > Output 字段获取任务结果。下方列出了 相关数据结构 以供参考。相关数据结构
常见问题
是否支持处理多个视频文件？
支持。您可以在
InputInfo 结构中传入第一集视频，其余视频可以通过ExtendedParameter 传入（将下载 URL 填入extendData参数中），注意需要按集数顺序。ProcessMedia 示例：{"InputInfo":{"Type":"URL","UrlInputInfo":{"Url":"https://website.com/input/ep1.mp4"//第一集}},"OutputStorage":{"Type":"COS","CosOutputStorage":{"Bucket":"test","Region":"ap-nanjing"}},"OutputDir":"/mps_test/output/","AiAnalysisTask":{"Definition":35,"ExtendedParameter":"{\\"reel\\":{\\"processType\\":\\"narrate\\",\\"narrateParam\\":{\\"onlyNarration\\":1},\\"extendData\\":[{\\"url\\":\\"https://website.com/input/ep2.mp4\\"},{\\"url\\":\\"https://website.com/input/ep3.mp4\\"},{\\"url\\":\\"https://website.com/input/ep4.mp4\\"}]}}" //更多视频文件按顺序填入ExtendedParameter->extendData中
