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