更新时间:2023-02-28 11:58:45
此接口允许您对 Cloud VoD 上的一个或多个视频执行转码。
- 该接口的响应仅表示请求是否成功。实际的转码结果需要通过API“Video Transcoding Callback”获取。
- 不支持对正在转码的视频进行转码。
- 如果源视频文件设置为转码完成后删除,您将无法再次转码视频。
- 当您对已经转码的视频进行转码时,转码后的视频将被新转码后的视频替换。
- 如果视频卡在转码状态,请联系云视频技术人员处理。
请求方法 | POST/GET |
---|---|
API接口地址 | https://api.cloudv.haplat.net/vod/videoManage/transCode |
是否需要鉴权 | 是的 |
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
videoIds | sting | 是 | 视频ID,多个ID用“,”分隔。 |
waterMarkTemplateName | sting | 不 | 水印模板名称,默认不加水印,您可以在云点播平台中选择模板为视频加水印。 |
transCodeTemplateName | sting | 不 | 转码模板名称,不指定则使用默认的转码模板。 |
watermarkTemplateId | sting | 不 | 水印模板ID,默认不加水印,可以选择给视频加水印的模板。 |
transCodeTemplateId | sting | 不 | 转码组合模板ID,不指定则使用默认的转码模板。 |
对于常用的响应,请访问通用响应。
请求示例
curl -X POST
http://api.cloudv.haplat.net/vod/videoManage/transCode
-H 'content-type: application/x-www-form-urlencoded; charset=utf-8'
-H "Authorization: your token"
-H "X-WS-Timestamp: current timestamp"
-H "X-WS-AccessKey: your AccessKey ID"
-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 | videoId 不能只包含“,” |
1543 | 水印模板名称过长 |
1544 | 转码模板名称过长 |
1545 | VideoId 不存在!或者您没有访问视频的权限! |
1546 | 水印模板不存在 |
1547 | 转码模板不存在 |
1549 | VideoIds 包含非活动视频 ID |
1551 | 无默认转码模板 |
1636 | 某些 videoIds 的源视频文件丢失 |