产品动态
产品公告
高光集锦接入
概述
精彩集锦功能可以通过智能算法自动捕捉并生成视频中的精彩片段，为用户提供快速回顾与分享，辅助提升后期制作的效率。
集锦场景及计费说明
处理类型 | 精彩集锦版本分类 | 描述 | 支持视频场景 | 计费说明 |
处理离线文件 | 精彩集锦-大模型版 | 基于大模型视频理解，自动分析视频内容，从而提取出关键场景和亮点时刻。可自定义调整视频理解 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. 然后，在步骤“处理输入文件”处，加入智能分析节点。
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 字段获取任务结果。发起直播流处理任务
使用智能分析-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 发起请求
其中
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}}"}}
接收任务回调结果
任务管理协议
附：扩展参数字段说明
参数 | 是否必填 | 类型 | 说明 |
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 定义列表，可以指定 prompt 来输出自己想要的结果，用法可以参考大模型示例。 |
scenario | No | string | 指定场景， force_cls 为10020时生效。 |
model_segment_limit | No | Array | 注意：这个参数是控制模型输出时长， 具体还是以模型输出为主。 输出视频长度限制， 会输入给模型作为参考，不是强制值，force_cls 为10020时生效，示例： "model_segment_limit":[3,6] // 期望大模型输出分片在3到6秒。 |
prompts 结构
参数 | 是否必填 | 类型 | 说明 |
multimodal_prompt | No | string | 多模态模型 prompt。 |
文档反馈