提交媒体转码任务
提交媒体转码任务
基本信息
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"
}
}
