媒体处理 精彩集锦接入

二、集锦场景及计费说明

MPS 精彩集锦支持以下版本，分别适用于不同视频场景。详细定价请参考 按量计费 文档。

三、免费体验

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 时刻等高光片段，辅助提升后期制作的效率。

你可以自定义 Prompt 进行拆条，扩展参数示例如下：

{"hht":{"force_cls":10010,"prompts":{"multimodal_prompt":"综艺歌曲拆分任务：只输出每首歌的表演部分，每首歌曲作为一个独立片段。严格排除：主持人介绍、串场、过渡语、问答、静音、纯说话、报幕、谢幕等与演唱无关的内容；片段起止必须落在「歌手正在演唱」的时段内。要求：1) 每段仅包含一首歌的完整演唱，从该首第一句歌词/前奏演唱开始，到该首最后一句歌词或尾奏结束；2) 不与其他歌曲合并，不截断在歌曲中间；3) 若某时段为说话、介绍或静场，一律不选。输出时仅包含纯表演片段，每首歌曲一个高光片段。"},"merge_type":0,"top_clip":100,"model_segment_limit":[10,90]}}

如果你不希望自定义 Prompt，也可以直接通过 scenario 参数传入 drama。系统会自动识别视频类型（包括短剧、漫剧、电视剧、综艺等）并进行拆条。扩展参数示例如下：

{"hht":{"force_cls":"10010","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1,"scenario":"drama"}}

九、精彩集锦-高级版

足球赛事场景

基于视频内容理解，自动识别并提取足球赛事视频中的关键行为事件，包括射门、进球、点球、红牌、黄牌、回放等关键行为事件。

{"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 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://mybucket.cos-internal.ap-guangzhou.tencentcos.cn/test/demo.mp4" } }, "OutputStorage": {//输出文件保存路径 "Type": "COS", "CosOutputStorage": { "Bucket": "mybucket-123456789", "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 字段获取任务结果。

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

使用精彩集锦，需要使用媒体处理 “智能分析”下的 26 号预设模板发起任务，暂不支持创建自定义模板调整集锦参数。指定集锦版本、指定视频场景等参数调整需求，你需要通过在发起任务时额外传入扩展参数来实现，具体参考下文 集锦场景&扩展参数示例 描述。

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

目前仅支持使用预设26号模板发起精彩集锦任务，无法自定义模板调整集锦参数。指定集锦版本、指定视频场景等参数调整需求，你需要通过在发起任务时额外传入扩展参数来实现。以下是常见直播集锦场景及对应扩展参数示例：

注意：说明：

22、广电新媒体直播

{"hht":{"force_cls":10010,"scenario":"news"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true, "caller":"live"}}

23、在线教育直播

{"hht":{"force_cls":10010,"scenario":"education"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true}}

24、电商带货直播

{"hht":{"force_cls":10010,"scenario":"E-commerce"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true}}

25、金融直播

{"hht":{"force_cls":10010,"scenario":"finance"}, "des":{"sent_threshold":250,"time_threshold":600},"live":{"ssrf_ignore":true}}

26、足球体育赛事直播

{"hht":{"force_cls":4001,"football_close_replay":1},"live":{"ssrf_ignore":true,"caller":"live"}}

27、API 发起任务

注意：说明：

注意：暂仅支持通过 API 发起直播流集锦处理任务。

28、通过 API Explorer 发起请求

调用 API 发起直播流处理任务可参见 对直播流发起处理 文档。在文档中单击内容描述的 API Explorer 调试，进入页面填写相关参数信息后即可发起在线调用。

其中 Definition 填26，表示使用智能分析-26号预设模板，发起集锦任务。ExtendedParameter 用于指定集锦场景，参数填写示例见上文 指定直播集锦场景&扩展参数示例 部分。注意，使用 API Explorer 时，ExtendedParameter 填 JSON 即可无需转义。

29、通过 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}}" }}

30、接收任务回调结果

参见 解析直播流处理结果 文档，解析 AiAnalysisResultInfo 字段。

31、任务管理协议

参见 任务管理文档，对已发起的任务进行管理。

32、附：扩展参数字段说明

33、prompts 结构

34、segment_required 结构

35、extend_data 结构