检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 媒体处理服务对应的接口列表如下所示,在调用媒体处理API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权,具体如何调用媒体处理API请参考应用示例。 自定义转码模板 转码模板用于定义转码后的视频信息,视频转码时,需提前创建转码模板。 接口 说明 POST
资源对账 媒体处理支持核对费用账单是否与资源实际用量相符。 查看资源包详情 如果您已购买资源包,您可以查看已购买资源包的使用情况。 登录华为云费用中心。 在左侧导航栏中,选择“资源包”,进入“资源包”页面,可查看全部资源包的详细信息。 更多资源包的详细介绍请参见费用中心资源包。 核对资源用量是否与实际相符
如何调用API 构造请求 认证鉴权 返回结果
媒体处理服务拥有您所有桶的读写权限。子账号不支持委托授权。 媒体处理服务通过您的角色访问对象存储资源,转码后的文件属于您的角色,可以继承输出桶的桶策略。 操作步骤 登录媒体处理控制台。 在左侧导航中,选择“云资源授权”,进入“云资源授权”页面。 选择授权方式,您只能选择其中一种授权方式。 委托授权 打开
API和SDK使用 支持批量下发转码任务吗? MPC接口是否是异步的,从提交到执行需要多长时间? 使用API转码MP3失败,提示原视频宽高错误 为什么调用API时返回“The token must be updated”? 为什么调用API时返回信息提示Token无效? 使用SD
SDK & API对应关系 表1 SDK与API对应关系 接口 API 说明 createTranscodingTask POST /v1/{project_id}/transcodings 创建转码任务 deleteTranscodingTask DELETE /v1/{pro
说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候,PATCH可能会去创建一个新的资源。
为什么调用API时返回“The token must be updated”? 以下两种情况可能会导致调用API时返回The token must be update: 您获取的Token已过期,Token认证的Token有效期为24小时,当Token过期时会返回该提示信息。 您
云资源授权时看不到桶怎么办? 云资源授权时,会展示您所在区域的桶列表。若没有看到桶,可按照如下步骤排查。 排查桶所在区域与转码所在区域是否一致。 登录媒体处理控制台,查看转码所在区域,如图1所示。 图1 媒体处理区域 登录OBS控制台,查看OBS桶所在区域,如图2所示。 图2 OBS桶所在区域
为什么调用API时返回信息提示Token无效? 可能原因是获取用户Token时,将Token的使用范围参数“scope”设置为“domain”,该Token适用于全局级服务,而媒体处理服务为项目级服务,需将“scope”设置为“project”。 父主题: API和SDK使用
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于管理员创建IAM用户接口,返回如图1所示的消息头,其中“X-Subject-To
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
终端节点 终端节点即调用API的请求地址,您可以从地区和终端节点中查询服务的终端节点。 约束与限制 媒体处理服务设置了API流量控制,避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下: 单租户接口流控:100次/分钟。 接口总体流控:1000次/分钟。
使用API转码MP3失败,提示原视频宽高错误 可能是由于使用的转码模板中设置了水印,删除水印后重新转码即可。删除水印方法请参见删除水印模板接口。 父主题: API和SDK使用
绝访问,建议直接修改该请求,不要重试该请求。 404 Not Found 所请求的资源不存在。 建议直接修改该请求,不要重试该请求。 405 Method Not Allowed 请求中带有该资源不支持的方法。 建议直接修改该请求,不要重试该请求。 406 Not Acceptable
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MPC.10089 The template file does not exist. 模板文件不存在 模板文件不存在,请检查 400
附录 状态码 错误码 获取项目ID 获取账号ID
本月统计 您可查看媒体处理服务本月的资源用量统计。 图1 资源用量 资源用量包括视频任务数和转码总时长。 统计项 描述 转码时长 转码耗时的总时长 调用转码API次数 调用转码API的总次数。 使用趋势 您可查看最近一周、最近一月及自定义时间内的资源用量使用趋势。 图2 转码统计趋势图
“我的凭证”。 进入“我的凭证 > API凭证”页面,如图1所示。 图1 项目列表 资源ID仅在计费时使用,媒体处理控制台界面无法查询到资源ID信息。 资源ID和媒体直播账单中的计费产品类型的对应关系,如表1所示。 同一账号同一项目下的不同资源ID中的ProjectID均相同。 表1
使用SDK或API报错“对象存储源地址或者目的地址无效” 可能是由于设置的OBS桶所在的region与获取token的region不一致,媒体处理服务不支持跨区域处理OBS桶中的音视频,您需要将OBS桶所在的region设置成与获取token的region一致。 父主题: API和SDK使用