检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
第二十七次正式发布 本次变更如下: 媒资转码接口组新增删除转码任务记录、查询点播概览信息接口。 转封装接口组新增删除转封装任务记录接口。 新增授权与配置接口组。 2022-08-26 第二十六次正式发布 本次变更如下: 修改新建截图任务、新建转码模板组和更新水印模板接口的格式错误。 修改新建转码任
状态码 调用媒体处理API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
查询任务概览信息 功能介绍 查询任务最近一周、最近一月或者自定义时间段的任务时长的统计概览信息。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/transcodings/summaries 表1 路径参数 参数 是否必选 参数类型 描述 project_id
查询转封装任务 功能介绍 查询转封装任务状态。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/remux 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数
示例2:提交视频转码任务 场景描述 若您需要将存储在OBS桶中的视频文件进行转码,并添加图片水印,您可以调用MPC API进行转码处理。 本章节指导用户如何使用API调用的方式提交视频转码任务。 接口约束 不支持处理跨区域的媒资文件,如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
查询转码任务 功能介绍 查询转码任务状态。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
附录 状态码 错误码 获取项目ID 获取账号ID
取消独立加密任务 功能介绍 取消独立加密任务。该API已废弃。 约束: 只能取消正在任务队列中排队的任务。已开始加密或已完成的加密任务不能取消。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/encryptions 表1 路径参数 参数
使用SDK或API报错“对象存储源地址或者目的地址无效” 可能是由于设置的OBS桶所在的region与获取token的region不一致,媒体处理服务不支持跨区域处理OBS桶中的音视频,您需要将OBS桶所在的region设置成与获取token的region一致。 父主题: API和SDK使用
新建视频解析任务 功能介绍 创建视频解析任务,解析视频元数据。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/extract-metadata 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
租户开通 租户开通媒体转码服务 租户查询服务开通状态信息
媒体处理可以在提交视频转码任务时配置截图参数,实现截图。若需要单独仅对某个视频文件进行截图而不转码,则可以调用视频截图接口来处理。 本章节指导用户如何使用API调用的方式提交视频截图任务。 接口约束 不支持处理跨区域的媒资文件,如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
总体流程 获取用户Token 创建转码模板 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于MPC接口调用时的认证鉴权。 在“我的凭证”页面获取us
新建独立加密任务 功能介绍 支持独立加密,包括创建、查询、删除独立加密任务。该API已废弃。 接口约束 加密的文件必须是m3u8或者mpd结尾的文件。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/encryptions 表1 路径参数 参数
查询转动图任务 功能介绍 查询动图任务的状态。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/animated-graphics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
功能介绍 取消已下发转码任务。 只能取消正在转码任务队列中排队的转码任务。已开始转码或已完成的转码任务不能取消。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id
应用示例 示例1:新建转码模板 示例2:提交视频转码任务 示例3:提交视频截图任务
新建转码模板 功能介绍 新建转码模板,采用自定义的模板转码。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。
视频解析接口 新建视频解析任务 查询视频解析任务 取消视频解析任务