媒体处理 智能标签接入

一、版本说明

版本	说明	扩展参数
基础版	默认能力，无需传扩展参数，提供基础标签识别。	不传ExtendedParameter
高级版	基于大模型理解深度分析，标签置信度更高，维度更丰富。	{"tag":{"process_type":"1103"}}

二、计费说明

视频标签按视频时长计费，具体价格请参考 MPS 定价文档。

三、步骤一：开通服务

登录腾讯云媒体处理控制台，按照引导开通 MPS 服务。

四、步骤二：授权 COS 存储桶

MPS 需要对你的 COS 存储桶进行读写操作，请确保已授予 MPS 服务角色对目标 Bucket 的读写权限。

五、步骤三：创建智能分析模板

注意：说明：

注意：与精彩集锦等功能不同，大模型标签没有预设模板，需要用户自行创建智能分析模板。

1. 进入 MPS 控制台，在左侧导航栏选择模板管理 > 媒体 AI 模板。

2. 进入智能分析页面，单击创建智能分析模板。

3. 填写模板名称，支持中文、英文、数字、_、-和.，长度不超过64个字符。

4. 在内容分析项配置中，开启智能视频标签。

5. 单击创建，并记录生成的模板 ID（后续发起任务时需使用）。

六、方式一：通过控制台发起任务

1. 进入 MPS 控制台，在左侧导航栏选择创建任务。

2. 单击创建离线文件处理任务，输入源配置：选择待处理视频的 COS 路径或 URL。

3. 添加智能分析节点。

4. 选择步骤三中创建的自定义智能分析模板。

5. 如需使用高级版，在扩展参数中填写：{"tag":{"process_type":"1103"}}。

6. 指定输出存储路径。

7. 填写完成后，单击创建提交任务。

七、方式二： API 调用

调用发起媒体处理 API，传入输入视频、输出路径，指定模板 ID 和扩展参数，示例&说明如下：

请求示例

{ "InputInfo": {//输入视频地址 "Type": "URL", "UrlInputInfo": { "Url": "https://example.cos.ap-guangzhou.myqcloud.com/input/video.mp4" } }, "OutputStorage": {//输出存储桶 "Type": "COS", "CosOutputStorage": { "Bucket": "your-bucket-1250000000", "Region": "ap-guangzhou" } }, "OutputDir": "/output/tag/",//输出路径 "AiAnalysisTask": { "Definition": <自定义模板ID>,//填入开启了智能标签功能的模板ID "ExtendedParameter": "{\\"tag\\":{\\"process_type\\":\\"1103\\"}}" //扩展参数，传入示例参数表示使用高级版，不传扩展参数则是基础版 }}

参数说明

参数	类型	是否必填	说明
InputInfo.Type	String	是	输入类型：URL 或 COS。
InputInfo.UrlInputInfo.Url	String	条件必填	Type 为 URL 时，填写视频地址。
InputInfo.CosInputInfo.Bucket	String	条件必填	Type 为 COS 时，填写存储桶名称。
InputInfo.CosInputInfo.Region	String	条件必填	Type 为 COS 时，填写存储桶地域。
InputInfo.CosInputInfo.Object	String	条件必填	Type 为 COS 时，填写对象路径。
OutputStorage.Type	String	是	输出存储类型，固定为 COS。
OutputStorage.CosOutputStorage.Bucket	String	是	输出存储桶名称。
OutputStorage.CosOutputStorage.Region	String	是	输出存储桶地域。
OutputDir	String	否	输出目录，默认为根目录。
AiAnalysisTask.Definition	Integer	是	自定义智能分析模板 ID（步骤三中创建的模板）。
AiAnalysisTask.ExtendedParameter	String	否	扩展参数 JSON 字符串（不传为基础版，传入则为高级版）。

扩展参数说明

智能标签版本	ExtendedParameter
基础版标签能力	不传（或传空）
高级版标签能力，基于大模型处理	{"tag":{"process_type":"1103"}}注意：控制台发起任务可以直接传入 JSON 扩展参数。但调用 API 时，需要将 JSON 对象序列化为字符串形式：{\\"tag\\":{\\"process_type\\":\\"1103\\"}}

八、方式一：控制台查询

1. 进入 MPS 控制台，在左侧导航栏选择任务管理 > 离线任务管理。

2. 找到对应任务，查看子任务状态。

3. 任务完成后，单击任务详情JSON 查看标签分析结果。

九、方式二：接口查询

调用 DescribeTaskDetail 接口，传入 TaskId 查询任务详情。

请求示例：

{ "TaskId": "2600011633-WorkflowTask-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}

响应结果中的标签信息位于：TaskDetail -> WorkflowTask -> AiAnalysisResultSet -> TagTask

十、方式三：事件通知回调

在发起任务时配置 TaskNotifyConfig 参数，任务完成后 MPS 会向指定 URL 推送回调通知。

{ "TaskNotifyConfig": { "NotifyType": "URL", "NotifyUrl": "https://your-domain.com/callback" }}

收到回调后，使用 ParseNotification 接口解析通知内容。

十一、相关接口

接口	说明
ProcessMedia	发起媒体处理任务。
DescribeTaskDetail	查询任务详情。
ParseNotification	解析事件通知。