检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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 构造请求 认证鉴权 返回结果
为什么调用API时返回“The token must be updated”？ 以下两种情况可能会导致调用API时返回The token must be update： 您获取的Token已过期，Token认证的Token有效期为24小时，当Token过期时会返回该提示信息。 您
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口，您可以从接口的请求部分看到所需的请求参数及参数
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-To
为什么调用API时返回信息提示Token无效？ 可能原因是获取用户Token时，将Token的使用范围参数“scope”设置为“domain”，该Token适用于全局级服务，而媒体处理服务为项目级服务，需将“scope”设置为“project”。 父主题： API和SDK使用
暂只支持输出GIF文件。 待转动图的视频文件需要存储在与媒体处理服务同区域的OBS桶中，且该OBS桶已授权。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/animated-graphics 表1 路径参数 参数 是否必选 参数类型 描述
使用API转码MP3失败，提示原视频宽高错误 可能是由于使用的转码模板中设置了水印，删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题： API和SDK使用
管理控制台 在“API凭证”页面的项目列表中查看项目ID。 图2 获取项目ID 调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为I
取消转动图任务 功能介绍 取消已下发的生成动图任务，仅支持取消排队中的任务。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/animated-graphics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
视频转码前需要配置转码模板。 待转码的音视频需要存储在与媒体处理服务同区域的OBS桶中，且该OBS桶已授权。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id
创建转封装任务，转换音视频文件的格式，但不改变其分辨率和码率。 待转封装的媒资文件需要存储在与媒体处理服务同区域的OBS桶中，且该OBS桶已授权。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/remux 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MPC.10089 The template file does not exist. 模板文件不存在 模板文件不存在，请检查 400
待截图的视频文件需要存储在与媒体处理服务同区域的OBS桶中，且该OBS桶已授权。 约束： 暂只支持生成JPG格式的图片文件。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/thumbnails 表1 路径参数 参数 是否必选 参数类型 描述 project_id
取消转封装任务 功能介绍 取消已下发的转封装任务，仅支持取消排队中的任务。。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/remux 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
终端节点 终端节点即调用API的请求地址，您可以从地区和终端节点中查询服务的终端节点。 约束与限制 媒体处理服务设置了API流量控制，避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下： 单租户接口流控：100次/分钟。 接口总体流控：1000次/分钟。
取消视频解析任务 功能介绍 取消已下发的视频解析任务，仅支持取消排队中的任务。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/extract-metadata 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
