检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 媒体处理服务对应的接口列表如下所示,在调用媒体处理API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权,具体如何调用媒体处理API请参考应用示例。 自定义转码模板 转码模板用于定义转码后的视频信息,视频转码时,需提前创建转码模板。 接口 说明 POST
如何调用API 构造请求 认证鉴权 返回结果
API和SDK使用 支持批量下发转码任务吗? MPC接口是否是异步的,从提交到执行需要多长时间? 使用API转码MP3失败,提示原视频宽高错误 为什么调用API时返回“The token must be updated”? 为什么调用API时返回信息提示Token无效? 使用SD
SDK & API对应关系 表1 SDK与API对应关系 接口 API 说明 createTranscodingTask POST /v1/{project_id}/transcodings 创建转码任务 deleteTranscodingTask DELETE /v1/{pro
为什么调用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使用
使用API转码MP3失败,提示原视频宽高错误 可能是由于使用的转码模板中设置了水印,删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题: API和SDK使用
使用SDK或API报错“对象存储源地址或者目的地址无效” 可能是由于设置的OBS桶所在的region与获取token的region不一致,媒体处理服务不支持跨区域处理OBS桶中的音视频,您需要将OBS桶所在的region设置成与获取token的region一致。 父主题: API和SDK使用
终端节点 终端节点即调用API的请求地址,您可以从地区和终端节点中查询服务的终端节点。 约束与限制 媒体处理服务设置了API流量控制,避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下: 单租户接口流控:100次/分钟。 接口总体流控:1000次/分钟。
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于管理员创建IAM用户接口,返回如图1所示的消息头,其中“X-Subject-To
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
MPC是否支持视频旋转? 支持,您可以通过调用API或者转码SDK,在转码时设置视频处理控制参数,对视频进行旋转。 API调用 上传源视频至OBS服务。上传步骤请参见上传音视频文件。 调用新建转码任务接口,设置输入输出参数“input”和“output”、转码模板“IDtrans
支持批量下发转码任务吗? MPC控制台和API均不支持批量下发转码任务,仅支持逐个创建音视频转码任务。您可以在应用系统里自行开发批量任务下发功能。 父主题: API和SDK使用
附录 状态码 错误码 获取项目ID 获取账号ID
租户开通 租户开通媒体转码服务 租户查询服务开通状态信息
应用示例 示例1:新建转码模板 示例2:提交视频转码任务 示例3:提交视频截图任务
状态码 调用媒体处理API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。
转动图接口 新建转动图任务 查询转动图任务 取消转动图任务
第二十七次正式发布 本次变更如下: 媒资转码接口组新增删除转码任务记录、查询点播概览信息接口。 转封装接口组新增删除转封装任务记录接口。 新增授权与配置接口组。 2022-08-26 第二十六次正式发布 本次变更如下: 修改新建截图任务、新建转码模板组和更新水印模板接口的格式错误。 修改新建转码任