检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 媒体处理服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。 自定义转码模板 转码模板用于定义转码后的视频信息，视频转码时，需提前创建转码模板。 接口 说明 POST
API和SDK使用 支持批量下发转码任务吗？ MPC接口是否是异步的，从提交到执行需要多长时间？ 使用API转码MP3失败，提示原视频宽高错误 为什么调用API时返回“The token must be updated”？ 为什么调用API时返回信息提示Token无效？ 使用SD
您可根据转码任务ID、状态、页码数、开始和结束时间，查询单个或多个转码任务的执行情况。 在查询到的结果集中，如果不提供页码数和显示条数并且数据大于10条，会默认显示10条数据并进行分页处理。 具体查询条件和查询结果参数请参考查询转码任务接口。 查询单个转码任务 1 2 3 4 5 //按单个Task
SDK & API对应关系 表1 SDK与API对应关系 接口 API 说明 createTranscodingTask POST /v1/{project_id}/transcodings 创建转码任务 deleteTranscodingTask DELETE /v1/{pro
如何调用API 构造请求 认证鉴权 返回结果
为什么调用API时返回“The token must be updated”？ 以下两种情况可能会导致调用API时返回The token must be update： 您获取的Token已过期，Token认证的Token有效期为24小时，当Token过期时会返回该提示信息。 您
为什么调用API时返回信息提示Token无效？ 可能原因是获取用户Token时，将Token的使用范围参数“scope”设置为“domain”，该Token适用于全局级服务，而媒体处理服务为项目级服务，需将“scope”设置为“project”。 父主题： API和SDK使用
MPC接口是否是异步的，从提交到执行需要多长时间？ 是异步的，如果提交的是少量任务， 则会立即执行， 如果同时提交大批量任务，则部分任务会有排队执行情况。 父主题： API和SDK使用
使用API转码MP3失败，提示原视频宽高错误 可能是由于使用的转码模板中设置了水印，删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题： API和SDK使用
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-To
待截图处理的视频文件已经存储在OBS桶中，您可以调用OBS上传对象API上传。 已创建用于存储截图文件的OBS桶，您可以调用OBS创建桶API进行创建。 总体流程 获取用户Token 创建截图任务 查询视频截图执行情况 操作步骤 获取用户Token，用于MPC接口调用时的认证鉴权。 在“我的凭证”页面获取
使用SDK或API报错“对象存储源地址或者目的地址无效” 可能是由于设置的OBS桶所在的region与获取token的region不一致，媒体处理服务不支持跨区域处理OBS桶中的音视频，您需要将OBS桶所在的region设置成与获取token的region一致。 父主题： API和SDK使用
租户开通 租户开通媒体转码服务 租户查询服务开通状态信息
示例2：提交视频转码任务 场景描述 若您需要将存储在OBS桶中的视频文件进行转码，并添加图片水印，您可以调用MPC API进行转码处理。 本章节指导用户如何使用API调用的方式提交视频转码任务。 接口约束 不支持处理跨区域的媒资文件，如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口，您可以从接口的请求部分看到所需的请求参数及参数
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
终端节点 终端节点即调用API的请求地址，您可以从地区和终端节点中查询服务的终端节点。 约束与限制 媒体处理服务设置了API流量控制，避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下： 单租户接口流控：100次/分钟。 接口总体流控：1000次/分钟。
应用示例 示例1：新建转码模板 示例2：提交视频转码任务 示例3：提交视频截图任务
状态码 调用媒体处理API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。
附录 状态码 错误码 获取项目ID 获取账号ID
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
