检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于管理员创建IAM用户接口,返回如图1所示的消息头,其中“X-Subject-To
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数
使用API转码MP3失败,提示原视频宽高错误 可能是由于使用的转码模板中设置了水印,删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题: API和SDK使用
附录 状态码 错误码 获取项目ID 获取账号ID
终端节点 终端节点即调用API的请求地址,您可以从地区和终端节点中查询服务的终端节点。 约束与限制 媒体处理服务设置了API流量控制,避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下: 单租户接口流控:100次/分钟。 接口总体流控:1000次/分钟。
第二十七次正式发布 本次变更如下: 媒资转码接口组新增删除转码任务记录、查询点播概览信息接口。 转封装接口组新增删除转封装任务记录接口。 新增授权与配置接口组。 2022-08-26 第二十六次正式发布 本次变更如下: 修改新建截图任务、新建转码模板组和更新水印模板接口的格式错误。 修改新建转码任
应用示例 示例1:新建转码模板 示例2:提交视频转码任务 示例3:提交视频截图任务
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
状态码 调用媒体处理API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。
管理控制台 在“API凭证”页面的项目列表中查看项目ID。 图2 获取项目ID 调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”,其中{Endpoint}为I
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MPC.10089 The template file does not exist. 模板文件不存在 模板文件不存在,请检查 400
使用SDK或API报错“对象存储源地址或者目的地址无效” 可能是由于设置的OBS桶所在的region与获取token的region不一致,媒体处理服务不支持跨区域处理OBS桶中的音视频,您需要将OBS桶所在的region设置成与获取token的region一致。 父主题: API和SDK使用
租户开通 租户开通媒体转码服务 租户查询服务开通状态信息
总体流程 获取用户Token 创建转码模板 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于MPC接口调用时的认证鉴权。 在“我的凭证”页面获取us
示例2:提交视频转码任务 场景描述 若您需要将存储在OBS桶中的视频文件进行转码,并添加图片水印,您可以调用MPC API进行转码处理。 本章节指导用户如何使用API调用的方式提交视频转码任务。 接口约束 不支持处理跨区域的媒资文件,如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
租户开通媒体转码服务 功能介绍 租户开通媒体转码服务。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/tenant/access 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
租户查询服务开通状态信息 功能介绍 租户查询媒体转码服务开通状态信息。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/tenant/access 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
媒体处理可以在提交视频转码任务时配置截图参数,实现截图。若需要单独仅对某个视频文件进行截图而不转码,则可以调用视频截图接口来处理。 本章节指导用户如何使用API调用的方式提交视频截图任务。 接口约束 不支持处理跨区域的媒资文件,如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
MPC是否支持视频旋转? 支持,您可以通过调用API或者转码SDK,在转码时设置视频处理控制参数,对视频进行旋转。 API调用 上传源视频至OBS服务。上传步骤请参见上传音视频文件。 调用新建转码任务接口,设置输入输出参数“input”和“output”、转码模板“IDtrans