CDN加速

文档中心 云点播 开发手册 对指定视频转码

对指定视频转码

更新时间:2021-01-27 16:09:07

描述

通过该接口对指定的一个或多个视频进行转码;

注:

该接口响应结果仅表示请求成功与否,实际转码结果需要通过”获取视频转码状态“来获取。
不支持对转码中的视频进行转码。
如果转码组合中有指定删除源视频文件,则转码后的该视频不支持再次转码。
对非删除源视频的转码后的视频重新转码,将删除已转码文件,以及试看视频文件(如果有)。
如果有视频一直卡在转码中的状态,请联系云视频的技术人员处理。

请求说明

请求方式 Post/get
接口地址 https://api.cloudv.haplat.net/vod/videoManage/transCode
是否需要凭证 需要校验凭证

请求参数

参数名 类型 是否必填 描述
videoIds string       是       视频ID,多个视频通过“,“隔开;
waterMarkTemplateName string 水印模板名,默认不添加水印,可选择云点播管理平台中的模板为视频添加水印;
transCodeTemplateName string 转码组合模板名,默认使用云点播管理平台设置的默认模板,
watermarkTemplateId string 水印模板Id,默认不添加水印,可选择云点播管理平台中的模板为视频添加水印;
transCodeTemplateId string 转码组合模板ID,默认使用云点播管理平台设置的默认模板

返回参数

通用返回结果详见返回结果

示例

输入示例

 curl -X POST 
  http://api.cloudv.haplat.net/vod/videoManage/transCode 
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
  -H "Host: api.cloudv.haplat.net" 
  <公共的头部参数>
  <自定义的头部参数>
   -d 'videoIds=9bac2161015d10003fdae81b00000000%2C9ba11ae7015d1000503692a400000000&waterMarkTemplateName=%E5%85%83%E6%97%A6%E6%B0%B4%E5%8D%B0&transCodeTemplateName=%E6%B5%8B%E8%AF%95%E8%BD%AC%E7%A0%810&subtitleId=2e5359cf016a10001e638de000000000'

注意:示例中的“公共参数”参见公共参数说明文档

错误码

以下仅列出了接口业务逻辑相关的错误码,通用错误码详见 返回结果

错误码 描述
1540 videoIds不能为空
1541 videoIds包含特殊字符
1542 videoIds不能只包含逗号
1543 水印模板名称过长
1544 转码组合名称过长
1545 有videoIds不存在!或不属于您的权限范围!
1546 水印模板不存在
1547 转码组合模板不存在
1549 videoIds中有被屏蔽的视频
1551 默认转码组合不存在
1636 videoIds中有不存在源文件的视频