快速入门

最近更新时间:2025-09-24 11:39:42

我的收藏
本文档能帮助您快速了解和接入媒体处理服务。使用媒体处理服务的主要步骤如下:

前提条件

注册与登录

1. 注册腾讯云 账户并完成实名认证。
2. 登录腾讯云官网,选择云产品 > 视频服务 > 媒体处理,进入媒体处理控制台,免费开通服务。


授权

1、服务角色授权

目前媒体处理支持三种输入文件来源:对象存储(COS)云点播专业版(VOD Pro)、AWS S3、URL下载地址:
使用 COS:需要完成 COS 服务角色授权,允许 MPS 对您 COS 存储桶中的文件进行下载、转码和上传等读写操作。
使用 VOD Pro:需要完成 VOD 服务角色授权,允许 MPS 对您 VOD 专业版应用中的文件进行下载、转码和上传等读写操作。
使用 AWS S3:可以跳过服务角色授权,但需完成 AWS 对接 MPS
使用 URL 下载地址:可公网访问的文件下载 URL(必须是直接下载方式,暂不支持 Chunked 模式)。选择该输入方式,输出方式暂仅支持 COS 和 VOD Pro,因此您也需要完成服务角色授权。
说明
如果您未完成授权,则无法在媒体处理控制台进行 COS 相关操作,无法开启 事件通知功能


2、子账号授权

如果您使用腾讯云子账号,需要联系主账号为您的子账号授权 MPS 的读写操作权限,否则子账号无法正常使用 MPS。详细操作请参考 账号授权

操作步骤

媒体处理可以对您的音视频文件或直播流进行处理。
离线媒体处理(点播媒体处理):对离线音视频文件进行处理。
直播媒体处理:对直播流进行录制、智能识别与分析、质检等实时媒体处理。

离线媒体处理操作步骤

步骤一:发起任务

目前支持三种发起离线媒体处理任务的方式:
控制台创建任务:手动在控制台选择文件并发起处理任务。
自动触发任务:文件上传至 COS / AWS S3 存储桶后自动发起处理任务,无需手动在控制台创建任务。暂不支持 VOD 专业版自动触发。
API 发起任务:调用 API 接口发起任务,适用于批量处理已上传文件的场景。
方式一:控制台创建任务
1. 进入 控制台创建任务页面,单击创建离线文件处理任务

2. 创建离线文件处理任务页面填写如下信息:

2.1 指定输入文件
指定需要进行媒体处理的文件路径或 URL 地址。
2.2 
排处理流程
通过编排,您可以组合各功能,形成自动处理流程。
单击可添加功能节点,您可以在打开的抽屉浮层中编辑参数。
选择模板:使用系统预设或之前保存的模板参数。
自定义:自定义参数。

2.3 指定输出路径
指定处理后的输出文件的默认保存路径。
说明:
若您需要单独设置编排中某功能节点的输出路径,例如您在编排中添加了转码、增强、截图三个功能而您期望截图的输出文件存储在不同的路径中,可以单击截图节点,在更多设置 > 自定义截图输出路径中配置。您也可以调整不同功能输出文件的命名方式,详细可参见 文件名变量 说明。
方式二:自动触发任务
1. 进入 编排管理 > 离线编排 页面,单击创建离线编排
2. 配置触发 Bucket 与目录、输出 Bucket 与目录、具体任务流程等。具体配置说明请参见 离线编排配置说明



3. 编排默认为未启用自动触发状态。回到编排管理 > 离线编排页面,单击

,即可开启自动触发功能。

4. 在触发 Bucket 中上传需要处理的视频文件,将自动按照编排中的任务配置处理新上传的视频,无需手动在控制台创建任务。
说明
编排启用自动触发后,只对新上传至触发 Bucket 的视频文件生效,之前存放在触发 Bucket 中的文件不会被自动处理。
方式三:API 发起任务
参见 文档指引,通过 API ProcessMedia 发起任务。

步骤二:管理任务

1. 进入 离线任务管理 页面,可以看到您所发起的全部任务的列表。
2. 可以通过任务状态、任务 ID 等筛选需要处理的任务,点击展开详情可以查看子任务信息、同时支持单击重启来重启排队中的任务、播放源视频等操作。



3. 展开子任务列表,可以查看子任务相关信息,支持播放/查看子任务文件、下载子任务输出文件、查看子任务详细信息等操作。


直播媒体处理操作步骤

步骤一:发起任务

目前支持两种发起直播媒体处理任务的方式:
控制台快速创建任务:手动在控制台配置并发起处理任务。
API 发起任务:调用 API 接口发起任务。
方式一:控制台快速创建任务
1. 进入 控制台创建任务页面,单击快速创建直播处理任务



2. 按照页面说明,完成直播流地址、编排、输出保存路径等配置。当前控制台支持对直播流进行实时录制,详细模板配置请参见 直播录制模板

注意:
在创建直播录制任务时,请保证直播流地址填写正确。拉取直播流失败后,会执行3次重试,如仍无法获取直播流,录制任务将会返回失败。
方式二:API 发起任务
通过 API ProcessLiveStream 发起单个直播流处理任务。

步骤二:管理任务

进入 直播任务管理 页面,可以看到您所发起的全部直播媒体处理任务的列表。您可以对任务进行查看详情、终止任务等操作。




各功能详细接入教程

上文操作步骤部分,简单介绍了如何使用 MPS 控制台发起离线媒体处理、直播媒体处理。为便于接入,本章节提供各功能的详细接入指引:
处理类型
支持功能
接入教程
离线媒体处理(处理离线音视频文件)
音视频转码
加水印
DRM
截图
配置 截图模板,通过控制台或 API 发起任务即可
音视频增强
媒体 AI
智能字幕
智能擦除
大模型视频摘要
精彩集锦
智能拆条
智能横转竖
多模态检索
智能识别
配置 智能识别模板,通过控制台或 API(发起媒体处理)发起任务即可
详细接入文档撰写中
智能分析
配置 智能分析模板,通过控制台或 API(发起媒体处理)发起任务即可
详细接入文档撰写中
智能审核
配置 智能审核模板,通过控制台或 API(发起媒体处理)发起任务即可
详细接入文档撰写中
媒体质检
视频评测
控制台发起任务请参考:视频评测
API 暂未开放,如有需求请联系我们
直播媒体处理(处理直播流)
直播流录制
媒体AI
智能字幕
智能审核
暂仅支持通过 API(对直播流发起处理)发起任务
详细接入文档撰写中
智能识别
暂仅支持通过 API(对直播流发起处理)发起任务
详细接入文档撰写中
智能分析
暂仅支持通过 API(对直播流发起处理)发起任务
详细接入文档撰写中
媒体质检