检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
为什么调用API时返回信息提示Token无效? 可能原因是获取用户Token时,将Token的使用范围参数“scope”设置为“domain”,该Token适用于全局级服务,而媒体处理服务为项目级服务,需将“scope”设置为“project”。 父主题: API和SDK使用
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
使用API转码MP3失败,提示原视频宽高错误 可能是由于使用的转码模板中设置了水印,删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题: API和SDK使用
附录 状态码 错误码 获取项目ID 获取账号ID
获取项目ID 调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”,其中{Endpoint}为IAM的终端节点可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
终端节点 终端节点即调用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时,如果遇到“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调用的方式提交视频截图任务。 接口约束 不支持处理跨区域的媒资文件,如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
租户查询服务开通状态信息 功能介绍 租户查询媒体转码服务开通状态信息。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/tenant/access 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
MPC是否支持视频旋转? 支持,您可以通过调用API或者转码SDK,在转码时设置视频处理控制参数,对视频进行旋转。 API调用 上传源视频至OBS服务。上传步骤请参见上传音视频文件。 调用新建转码任务接口,设置输入输出参数“input”和“output”、转码模板“IDtrans