检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
单击“新增访问密钥”,在弹出的页面中输入账号密码及短信验证码。 图1 访问密钥 单击“确定”,即可下载一个命名为“credentials.csv”的文件,其中包含AK和SK。 获取项目ID和账号名 登录管理控制台。 鼠标移动至用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面,即可获取对应的项目ID和账号名信息。
消息通知的方式。在下拉框中选择需要订阅终端支持的协议。 常用的消息通知方式为“短信”、“邮件”、“HTTP”和“HTTPS”。 订阅终端 订阅的终端地址。短信、邮件、HTTP以及HTTPS终端支持批量输入。批量添加时,每个终端地址占一行,最多可输入10个终端。 选择“短信”,请输入有效手机号码。 输入规则为[+]
媒体处理可以在提交视频转码任务时配置截图参数,实现截图。若需要单独仅对某个视频文件进行截图而不转码,则可以调用视频截图接口来处理。 本章节指导用户如何使用API调用的方式提交视频截图任务。 接口约束 不支持处理跨区域的媒资文件,如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
警阈值。 华为云资源包支持使用量预警功能,如果您正在使用资源包,那么建议您开启剩余使用量预警,当资源包剩余使用量到达预警阈值,将会给您发送短信、邮件提醒。
第二十七次正式发布 本次变更如下: 媒资转码接口组新增删除转码任务记录、查询点播概览信息接口。 转封装接口组新增删除转封装任务记录接口。 新增授权与配置接口组。 2022-08-26 第二十六次正式发布 本次变更如下: 修改新建截图任务、新建转码模板组和更新水印模板接口的格式错误。 修改新建转码任
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
API概览 媒体处理服务对应的接口列表如下所示,在调用媒体处理API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权,具体如何调用媒体处理API请参考应用示例。 自定义转码模板 转码模板用于定义转码后的视频信息,视频转码时,需提前创建转码模板。 接口 说明 POST
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于管理员创建IAM用户接口,返回如图1所示的消息头,其中“X-Subject-To
如何调用API 构造请求 认证鉴权 返回结果
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数
为什么调用API时返回信息提示Token无效? 可能原因是获取用户Token时,将Token的使用范围参数“scope”设置为“domain”,该Token适用于全局级服务,而媒体处理服务为项目级服务,需将“scope”设置为“project”。 父主题: API和SDK使用
为什么调用API时返回“The token must be updated”? 以下两种情况可能会导致调用API时返回The token must be update: 您获取的Token已过期,Token认证的Token有效期为24小时,当Token过期时会返回该提示信息。 您
附录 状态码 错误码 获取项目ID 获取账号ID
使用API转码MP3失败,提示原视频宽高错误 可能是由于使用的转码模板中设置了水印,删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题: API和SDK使用
租户开通 租户开通媒体转码服务 租户查询服务开通状态信息
应用示例 示例1:新建转码模板 示例2:提交视频转码任务 示例3:提交视频截图任务
终端节点 终端节点即调用API的请求地址,您可以从地区和终端节点中查询服务的终端节点。 约束与限制 媒体处理服务设置了API流量控制,避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下: 单租户接口流控:100次/分钟。 接口总体流控:1000次/分钟。
视频解析接口 新建视频解析任务 查询视频解析任务 取消视频解析任务
转动图接口 新建转动图任务 查询转动图任务 取消转动图任务
状态码 调用媒体处理API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。