提交媒体转码任务

提交媒体转码任务

基本信息

Path: /api/v2/vod

接口描述:

提交媒体转码任务,开始异步转码处理,转码结果需等待事件回调。

结果请监听回调事件:视频单个清晰度转码完成, 视频全部清晰度普通转码完成,视频全部清晰度加密转码完成

注: 在转码清晰度方面,本服务当前使用“向下转码”的原则。 例如,上传的源视频清晰度为960x540,则只能向下转码为480p、360p、a,而无法向上转码成720p、1080p。

请求参数

Query

参数名称 类型 是否必须 示例 备注
action string 是 SubmitTranscodeTasks 固定参数,SubmitTranscodeTasks
app_id string 是 f4efa787 app_id
vod_id string 是 4377e1d5 点播ID
quality string 否 360p,same 指定转码清晰度,取值范围:
a
360p
480p
720p
1080p
same
如有多个,以逗号隔开
format string 否 hls 指定转码协议,取值范围:
hls(默认)
mp4
safe string 否 "1" "0"不加密,"1"加密

出参

参数 类型 是否必选 含义
task_id string 是 转码任务ID

返回数据

{
    "code": 200,
    "msg": "task pending",
    "request_id": "B36A562C-BBE7-4B16-9F4A-C7A03AC9D6E2",
    "data":{
        "task_id": "xxxxxxxxxxxxxx"
    }
}