媒体处理智能标签接入

概述
智能标签功能基于腾讯云媒体处理服务（MPS）的智能分析能力，利用大模型对视频内容进行深度理解与分析，自动为视频生成标签。该功能可广泛应用于视频内容分类、推荐系统、内容审核辅助、媒资管理等场景。
版本说明
版本
说明
扩展参数
基础版
默认能力，无需传扩展参数，提供基础标签识别。
不传
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﻿
解析事件通知。

版本	说明	扩展参数
基础版	默认能力，无需传扩展参数，提供基础标签识别。	不传 `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\\"}}`

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

智能标签接入

本页目录：

概述

版本说明

计费说明

接入前置操作

步骤一：开通服务

步骤二：授权 COS 存储桶

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

发起离线视频文件处理任务

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

方式二： API 调用

查询任务结果

方式一：控制台查询

方式二：接口查询

方式三：事件通知回调

相关接口