更新时间:2022-10-26 17:47:55
通过该接口对指定的一个或多个视频进行转码;
注:
该接口响应结果仅表示请求成功与否,实际转码结果需要通过”获取视频转码状态“来获取。
不支持对转码中的视频进行转码。
如果转码组合中有指定删除源视频文件,则转码后的该视频不支持再次转码。
对非删除源视频的转码后的视频重新转码,将删除已转码文件,以及试看视频文件(如果有)。
如果有视频一直卡在转码中的状态,请联系云视频的技术人员处理。
请求方式 | Post/get |
---|---|
接口地址 | https://open.chinanetcenter.com/vod/videoManage/transCode |
是否需要凭证 | 需要校验凭证 |
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
videoIds | string | 是 | 视频ID,多个视频通过“,“隔开; |
waterMarkTemplateName | string | 否 | 水印模板名,默认不添加水印,可选择云点播管理平台中的模板为视频添加水印; |
transCodeTemplateName | string | 否 | 转码组合模板名,默认使用云点播管理平台设置的默认模板, |
watermarkTemplateId | string | 否 | 水印模板Id,默认不添加水印,可选择云点播管理平台中的模板为视频添加水印; |
transCodeTemplateId | string | 否 | 转码组合模板ID,默认使用云点播管理平台设置的默认模板 |
通用返回结果详见返回结果
curl -X POST
http://open.chinanetcenter.com/vod/videoManage/transCode
-H 'content-type: application/x-www-form-urlencoded; charset=utf-8'
-H "Host: open.chinanetcenter.com"
<公共的头部参数>
<自定义的头部参数>
-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中有不存在源文件的视频 |