媒体处理精彩集锦接入

概述
精彩集锦功能可以通过智能算法自动捕捉并生成视频中的精彩片段，为用户提供快速回顾与分享，辅助提升后期制作的效率。
﻿
﻿
﻿
集锦场景及计费说明
MPS 精彩集锦支持以下版本，分别适用于不同视频场景。详细定价请参考 按量计费 文档。
处理类型
精彩集锦版本分类
描述
支持视频场景
计费说明
处理离线文件
精彩集锦-大模型版
基于大模型视频理解，自动分析视频内容，从而提取出关键场景和亮点时刻。可自定义调整视频理解 Prompt。
自定义场景
全景相机、VLOG 视频场景
短剧影视剧场景
收取“精彩集锦-大模型版”费用。
﻿
精彩集锦-高级版
高级版集锦算法，主要适配体育赛事类、游戏电竞类视频。
足球赛事
篮球赛事
游戏电竞视频
通用场景
收取“精彩集锦-高级版”费用。
﻿
精彩集锦-基础版
自2025年12月起，该模型版本下线，只为存量客户提供服务。
﻿
收取“精彩集锦-基础版”费用。
处理直播流
精彩集锦-直播流处理
基于大模型视频理解，针对直播场景进行了针对性模型优化。
广电新媒体直播
在线教育直播
电商带货直播
金融直播
足球篮球赛事直播
收取“精彩集锦-大模型版”费用。
免费体验
1. 打开 体验馆，进入高光集锦体验页，在右侧选择点播文件或直播流，指定视频内容分类，单击开始处理。
2. 等待处理完成后即可查看结果。
说明：
体验馆功能较简单，仅用于体验基础效果，测试完整效果请使用 API 接入。
﻿
接入前置操作
在接入精彩集锦前，为正常使用 MPS 产品，您需要完成以下前置操作：腾讯云账号注册和登录、开通 MPS 产品、授权服务角色。
具体指引请参考 快速入门。账号授权问题可参考 账号授权 文档。
发起离线视频文件处理任务
使用智能分析-26号预设模板
使用精彩集锦，需要使用媒体处理 “智能分析”下的 26 号预设模板发起任务，暂不支持创建自定义模板调整集锦参数。指定集锦版本、指定视频场景等参数调整需求，您需要通过在发起任务时额外传入扩展参数来实现，具体参考下文 集锦场景&扩展参数示例 描述。
﻿
指定离线集锦场景&扩展参数示例
目前仅支持使用预设26号模板发起精彩集锦任务，无法自定义模板调整集锦参数。指定集锦版本、指定视频场景等参数调整需求，您需要通过在发起任务时额外传入扩展参数来实现。以下是常见集锦场景及对应扩展参数示例：
说明：
本章节主要说明处理离线文件时，精彩集锦支持的处理场景及对应扩展参数示例。具体如何发起任务、如何传入扩展参数，请参考下文 发起处理任务 说明，扩展参数详细字段定义请参考下文 附录。
示例参数可能无法达到最佳集锦效果，建议根据视频特性微调参数。如需专业支持，请 联系我们。
精彩集锦-大模型版
自定义场景
multimodal_prompt 支持输入您的自定义 Prompt 需求。扩展参数示例如下：
//prompt示例，可自定义调整。详细字段定义请参考下文附录
{"hht":{"top_clip":5,"force_cls":10020,"prompts":{"multimodal_prompt":"滑雪场景，输出人物高光"},"scenario":"滑雪","model_segment_limit":[3,6]}}
﻿
全景相机、VLOG 视频场景
基于大模型视频理解，并针对 VLOG 视频、运动视频、风景视频、无人机全景视频等多种场景进行了针对性调优，可以精准获取拍摄过程中的精彩瞬间并进行生成高质量的集锦片段。扩展参数示例如下：
//平面视频高光。详细字段定义请参考下文附录
{"hht":{"top_clip":5,"force_cls":10020,"model_segment_limit":[3,6]}}
﻿
//全景视频高光。详细字段定义请参考下文附录
{"hht":{"top_clip":5,"force_cls":10020,"model_segment_limit":[3,6],"use_panorama_direct":1,"panorama_video":1}}
﻿
短剧影视剧场景
基于大模型视频理解，并针对短剧影视剧视频进行了针对性调优，可以自动提取主角出场时刻、BGM 时刻等高光片段，辅助提升后期制作的效率。
{"hht":{"force_cls":"10010","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1,"scenario":"电视剧高光"}}
﻿
精彩集锦-高级版
足球赛事场景
基于视频内容理解，自动识别并提取足球赛事视频中的关键行为事件，包括射门、进球、点球、红牌、黄牌、回放等关键行为事件。
{"hht":{"force_cls":"4001","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1}}
﻿
篮球赛事场景
{"hht":{"force_cls":"4002","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1}}
﻿
方式1：API 发起任务
1. API Explorer 快速验证
进入媒体处理 API Explorer 在线调试页面，在左侧接口列表选择 发起媒体处理 接口。参考下图填写输入路径、输出路径、模板ID等参数， 在AiAnalysisTask 任务配置中将 Definition 设置为 26（预设精彩集锦模板）即可指定发起精彩集锦任务。ExtendedParameter 为精彩集锦扩展参数，通过该参数指定不同集锦场景，实现特定的能力，具体请参考 集锦场景&扩展参数示例。
说明：
API Explorer 会自动转换，因此 ExtendedParameter 填写对应 json 即可，不用转换成字符串。但是如果直接调用 API，需要对 JSON 字符串转义。
﻿
﻿
﻿
﻿2. 使用 API 发起
上文介绍了如何使用 API explorer 在线调用接口并调试。您也可以直接向腾讯云发起 POST 请求，接口请求域名：mps.tencentcloudapi.com。发起 POST 请求， definition 为预设精彩集锦模板 ID（26），下面为 发起媒体处理 的请求范例：
注意：
直接调用 API，在传入 ExtendedParameter 参数时，需要对 JSON 字符串转义。
{
    "InputInfo": { //输入文件路径
        "Type": "URL",
        "UrlInputInfo": {
            "Url": "https://mg-aidata-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/test/hht_test/MyStoryForYouEP39.mp4"
        }
    },
    "OutputStorage": {//输出文件保存路径
        "Type": "COS",
        "CosOutputStorage": {
            "Bucket": "mg-aidata-1258344699",
            "Region": "ap-guangzhou"
        }
    },
    "OutputDir": "/test_data/",
    "AiAnalysisTask": {
        "Definition": 26, //传26表示使用精彩集锦功能
        "ExtendedParameter": "{\\"hht\\":{\\"top_clip\\":5,\\"force_cls\\":10020,\\"prompts\\":{\\"multimodal_prompt\\":\\"滑雪场景，输出人物高光\\"},\\"scenario\\":\\"滑雪\\",\\"model_segment_limit\\":[3,6]}}" //扩展参数，用于指定集锦场景、实现特定能力，传参请参考文档说明
    }
}
方式2：控制台发起任务（零代码自动生成）
注意：
控制台发起任务需要使用预设模板（预设精彩集锦参数）。由于集锦存在一些特殊参数无法在模板中配置，可能会影响精彩集锦的效果，因此更推荐您使用 API 的方式接入。
1. 进入 媒体处理控制台，依次点击创建任务 > 创建离线文件处理任务。
﻿
2. 首先指定输入视频文件（目前精彩集锦功能暂不支持 AWS S3 作为输入源）。
3. 然后，在步骤“处理输入文件”处，加入智能分析节点。
﻿
在弹出的智能分析设置抽屉中，选择精彩集锦预设模板（模板ID：26）。您可以开启更多设置下的扩展参数，参考本文说明传入 扩展参数 来指定集锦场景、实现更好的集锦效果。
﻿
﻿
﻿
﻿
4. 最后，指定输出视频保存路径后，即可单击创建发起任务。
﻿
方式3：自动触发任务
若您希望实现：在 COS 桶中上传了视频文件，并自动按照预设参数进行精彩集锦处理。您可以在创建任务时单击保存此编排，在弹出的窗口中配置触发Bucket、触发目录等参数。
﻿
然后进入离线编排列表，找到刚创建好的编排，在启动处开启按钮即可。后续在触发目录下新增的视频文件，将自动按照该编排预设的流程和参数发起任务，并将处理后的视频文件保存到编排配置的输出路径中。
注意：
启用编排成功后，需要3-5分钟才会生效。
﻿
查询任务结果
控制台查询结果
1. 您可以在控制台 任务管理 页面查看任务状态，当子任务状态为“成功”时：
﻿
2. 单击回调JSON，可以在输出信息中找到输出结果和输出文件路径：
﻿
3. 如果使用 COS 作为输出路径，您可以在 MPS 控制台的 COS Bucket > 输出 Bucket 页面中找到您的输出目录，在目录下以hht开头的文件即为精彩集锦输出文件，包括每个集锦片段的视频和封面。
说明：
标题、摘要等文本内容不会输出至 Bucket 中，必须通过事件回调或接口查询。
﻿
事件通知回调
在使用 ProcessMedia 发起媒体处理任务时，您可以通过 TaskNotifyConfig 参数配置事件回调。当任务处理完成后，会通过配置的回调信息回调任务结果，您可以通过 ParseNotification 解析事件通知结果。
调用接口查询任务结果
在使用 ProcessMedia 发起媒体处理任务后，会返回任务 ID（TaskId），例如：24000022-WorkflowTask-b20a8exxxxxxx1tt110253、24000022-ScheduleTask-774f101xxxxxxx1tt110253。调用 DescribeTaskDetail 接口，输入任务 ID 即可获取任务结果，您需要解析 WorkflowTask ->AiAnalysisResultSet 或 ScheduleAnalysisTaskResult 字段获取任务结果。
发起直播流处理任务
使用智能分析-26号预设模板
使用精彩集锦，需要使用媒体处理 “智能分析”下的 26 号预设模板发起任务，暂不支持创建自定义模板调整集锦参数。指定集锦版本、指定视频场景等参数调整需求，您需要通过在发起任务时额外传入扩展参数来实现，具体参考下文 集锦场景&扩展参数示例 描述。
﻿
指定直播集锦场景&扩展参数示例
目前仅支持使用预设26号模板发起精彩集锦任务，无法自定义模板调整集锦参数。指定集锦版本、指定视频场景等参数调整需求，您需要通过在发起任务时额外传入扩展参数来实现。以下是常见直播集锦场景及对应扩展参数示例：
说明：
本章节主要说明处理直播流时，精彩集锦支持的处理场景及对应扩展参数示例，具体如何发起任务、如何传入扩展参数，请参考下文 发起处理任务 说明，扩展参数详细字段定义请参考下文 附录。
示例参数可能无法达到最佳集锦效果，建议根据视频特性微调参数。如需专业支持，请 联系我们。
广电新媒体直播
{"hht":{"force_cls":10010,"scenario":"news"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true, "caller":"live"}}
在线教育直播
{"hht":{"force_cls":10010,"scenario":"education"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true}}
﻿
电商带货直播
{"hht":{"force_cls":10010,"scenario":"E-commerce"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true}}
﻿
金融直播
{"hht":{"force_cls":10010,"scenario":"finance"}, "des":{"sent_threshold":250,"time_threshold":600},"live":{"ssrf_ignore":true}}
足球体育赛事直播
{"hht":{"force_cls":4001,"football_close_replay":1},"live":{"ssrf_ignore":true,"caller":"live"}}
﻿
API 发起任务
说明：
暂仅支持通过 API 发起直播流集锦处理任务。
通过 API Explorer 发起请求
调用 API 发起直播流处理任务可参见 对直播流发起处理 文档。在文档中单击内容描述的 API Explorer 调试，进入页面填写相关参数信息后即可发起在线调用。
其中 Definition 填26，表示使用智能分析-26号预设模板，发起集锦任务。ExtendedParameter 用于指定集锦场景，参数填写示例见上文 指定直播集锦场景&扩展参数示例 部分。注意，使用API Explorer时，ExtendedParameter 填JSON即可无需转义。
﻿
﻿
﻿
通过 API 发起
直接向腾讯云发起 POST 请求。注意，直接调用 API 时，ExtendedParameter 需要对 JSON 字符串转义。下面为请求的参考范例：
{
    "Url": "http://mps-pull.test.org/live/test.flv",
    "TaskNotifyConfig": {
        "NotifyType": "URL",
        "NotifyUrl": "http://test.cloud.com/callback"
    },
    "OutputStorage": {
        "Type": "COS",
        "CosOutputStorage": {
            "Bucket": "my-mpsdata-12345xxx99",
            "Region": "ap-guangzhou"
        }
    },
    "OutputDir": "/output/",
    "AiAnalysisTask": {
        "Definition": 26,
        "ExtendedParameter": "{\\"hht\\":{\\"top_clip\\":10, \\"force_cls\\":5003, \\"need_vad\\":1, \\"threshold\\":0.9, \\"merge_time\\":60, \\"merge_type\\":0, \\"res_save_type\\":1}}"
    }
}
接收任务回调结果
参见 解析直播流处理结果 文档，解析 AiAnalysisResultInfo 字段。
任务管理协议
参见 任务管理文档，对已发起的任务进行管理。
附：扩展参数字段说明
参数
是否必填
类型
说明
top_clip
No
int
选取置信度最高的集锦片段，默认值为5。
示例：\\"top_clip\\":10，表示最多输出置信度最高的10个集锦片段。
force_cls
No
int
指定集锦类别：
10010：短剧、电视剧场景
4001：足球
4002：篮球
1001：王者荣耀
100101：王者荣耀竞赛
1003：英雄联盟
10020: 大模型集锦，适用于自定义视频场景、vlog/风景视频场景等
need_vad
No
int
vad 用于判断视频一句话结尾，vad 扩展能够让视频语音完整，默认开启。
1：使用 vad
0：不使用
threshold
No
float
置信度阈值，低于阈值的片段都过滤掉，每种类型的集锦都会有默认阈值设置。
备注：建议客户初次使用时不设置。
res_save_type
No
int
是否存储结果，默认存储。
1：存储结果
0：只输出时间段
output_pattern
No
string
输出视频命名格式，{}表示占位符。
{year}-{month}-{day}-{hour}-{minute}-{second}_{start_dts}-{end_dts}-{timestamp}-{session}.mp4
默认输出格式：
hht-{year}{month}{day}{hour}{minute}-{session}-{timestamp}-index.mp4
image_pattern
No
string
image-{start_dts}.jpg
可以占位的参数同上
默认输出格式：
hht-{year}{month}{day}{hour}{minute}-{session}-{timestamp}-index.jpg
merge_type
No
int
注意：仅离线场景可用，默认值：5003 不合并，其他场景合并。
是否合并结果为一个视频：
1：合并（top_clip 参数不生效）
0：不合并（merge_time 参数不生效）
merge_time
No
int
注意：仅离线场景可用， 默认值：5003 为实际输出，其他场景最长不超过一小时。
合并成一个视频时，指定视频输出长度。
prompts
No
Object
prompts 定义列表。
scenario
No
string
场景， force_cls 为10020时生效。
model_segment_limit
No
Array
注意：这个参数是控制模型输出时长， 具体还是以模型输出为主。
输出视频长度限制， force_cls为10020时生效，示例：
"model_segment_limit":[3,6]
prompts 结构
参数
是否必填
类型
说明
multimodal_prompt
No
string
多模态模型 prompt。

处理类型	精彩集锦版本分类	描述	支持视频场景	计费说明
处理离线文件	精彩集锦-大模型版	基于大模型视频理解，自动分析视频内容，从而提取出关键场景和亮点时刻。可自定义调整视频理解 Prompt。	自定义场景全景相机、VLOG 视频场景短剧影视剧场景	收取“精彩集锦-大模型版”费用。
		精彩集锦-高级版	高级版集锦算法，主要适配体育赛事类、游戏电竞类视频。	足球赛事篮球赛事游戏电竞视频通用场景	收取“精彩集锦-高级版”费用。
		精彩集锦-基础版	自2025年12月起，该模型版本下线，只为存量客户提供服务。			收取“精彩集锦-基础版”费用。
处理直播流	精彩集锦-直播流处理	基于大模型视频理解，针对直播场景进行了针对性模型优化。	广电新媒体直播在线教育直播电商带货直播金融直播足球篮球赛事直播	收取“精彩集锦-大模型版”费用。

参数	是否必填	类型	说明
top_clip	No	int	选取置信度最高的集锦片段，默认值为5。示例：`\\"top_clip\\":10`，表示最多输出置信度最高的10个集锦片段。
force_cls	No	int	指定集锦类别： 10010：短剧、电视剧场景 4001：足球 4002：篮球 1001：王者荣耀 100101：王者荣耀竞赛 1003：英雄联盟 10020: 大模型集锦，适用于自定义视频场景、vlog/风景视频场景等
need_vad	No	int	vad 用于判断视频一句话结尾，vad 扩展能够让视频语音完整，默认开启。 1：使用 vad 0：不使用
threshold	No	float	置信度阈值，低于阈值的片段都过滤掉，每种类型的集锦都会有默认阈值设置。备注：建议客户初次使用时不设置。
res_save_type	No	int	是否存储结果，默认存储。 1：存储结果 0：只输出时间段
output_pattern	No	string	输出视频命名格式，{}表示占位符。 {year}-{month}-{day}-{hour}-{minute}-{second}_{start_dts}-{end_dts}-{timestamp}-{session}.mp4 默认输出格式： hht-{year}{month}{day}{hour}{minute}-{session}-{timestamp}-index.mp4
image_pattern	No	string	image-{start_dts}.jpg 可以占位的参数同上默认输出格式： hht-{year}{month}{day}{hour}{minute}-{session}-{timestamp}-index.jpg
merge_type	No	int	注意：仅离线场景可用，默认值：5003 不合并，其他场景合并。是否合并结果为一个视频： 1：合并（top_clip 参数不生效） 0：不合并（merge_time 参数不生效）
merge_time	No	int	注意：仅离线场景可用，默认值：5003 为实际输出，其他场景最长不超过一小时。合并成一个视频时，指定视频输出长度。
prompts	No	Object	prompts 定义列表。
scenario	No	string	场景， force_cls 为10020时生效。
model_segment_limit	No	Array	注意：这个参数是控制模型输出时长，具体还是以模型输出为主。输出视频长度限制， force_cls为10020时生效，示例： "model_segment_limit":[3,6]

精彩集锦接入

本页目录：

概述

集锦场景及计费说明

免费体验

接入前置操作

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

使用智能分析-26号预设模板

指定离线集锦场景&扩展参数示例

精彩集锦-大模型版

自定义场景

全景相机、VLOG 视频场景

短剧影视剧场景

精彩集锦-高级版

足球赛事场景

篮球赛事场景

方式1：API 发起任务

1. API Explorer 快速验证

﻿2. 使用 API 发起

方式2：控制台发起任务（零代码自动生成）

方式3：自动触发任务

查询任务结果

控制台查询结果

事件通知回调

调用接口查询任务结果

发起直播流处理任务

使用智能分析-26号预设模板

指定直播集锦场景&扩展参数示例

广电新媒体直播

在线教育直播

电商带货直播

金融直播

足球体育赛事直播

API 发起任务

通过 API Explorer 发起请求

通过 API 发起

接收任务回调结果

任务管理协议

附：扩展参数字段说明

prompts 结构

2. 使用 API 发起