接口名称 |
点播视频转码
签名
|
地址 |
https://api.cnlive.com/open/api2/vodtrans/avop |
method |
post |
返回数据 |
json
|
点播视频转码URL接口
接口说明: 针对视讯云平台上传内容的转码服务
请求方式: HTTP POST
返回格式: JSON
请求参数说明:
参数名 |
参数类型 |
必选 |
参数说明 |
appId |
string |
true |
应用ID |
params |
json |
true |
请求json数据 |
sign |
String |
true |
签名规则见 签名详情 |
params参数说明:
参数名 |
参数类型 |
必选 |
参数说明 |
plat |
int |
false |
转码平台,根据当前业务所应用的存储平台对应, 0:金山;1:七牛 默认为0 |
path |
string |
true |
源文件的相对路径 格式:/{bucket}/{object_name} |
dstBucket |
string |
false |
转码存储bucket,默认同源视频同bucket |
dstDir |
string |
true |
输出文件key的路径、不允许以/开头 |
type |
string |
true |
转码类型,针对该视频转码固定取值,type:avop |
rates |
string |
false |
码率集合、单位K,多个码率以逗号分隔。根据该参数返回指定的码率视频信息。取值范围:(流畅:400;标清:800;高清:1500;超清:3000) |
attach |
json |
false |
type相关附带参数 非必填 格式:json |
cbUrl |
string |
true |
回调用户地址,回调请求采用post body形式 |
extParam |
json |
false |
附加参数 json |
attach(转码加水印任务必填)参数说明:
参数名 |
参数类型 |
必选 |
参数说明 |
path |
string |
true |
logo源文件的相对路径 格式:/{bucket}/{object_name} |
position |
int |
false |
水印方位 默认值:0 取值范围:左上角:0;右上角:1;左下角:2;右下角:3; |
extParam参数说明:
参数名 |
参数类型 |
必选 |
参数说明 |
domain |
string |
false |
音视频源文件外链域名,plat=1时必填 |
avconcat |
string |
false |
添加片头、片尾,json字符串 |
startTime |
string |
false |
音视频剪辑开始时间点,不填即不计入剪辑范围。格式 HH : mm : ss(目前仅支持plat=0) |
endTime |
string |
false |
音视频剪辑结束时间点,不填即不计入剪辑范围 格式 HH : mm : ss(目前仅支持plat=0) |
avconcat 参数说明:
参数名 |
参数类型 |
必选 |
参数说明 |
headFile |
string |
false |
片头 格式:/{bucket}/{object_name} |
endFile |
string |
false |
片尾 格式:/{bucket}/{object_name} |
请求示例:
{
"appId":"82_XXX",
"params":{
"cbUrl":"http://test.transcode.cnlive.com/ts/defaultNotify",
"path":"/trans-test/60/1465695/vod/2017/0323/60_527f266385614dd48ad5a0932ffca16a.mp4",
"cbMethod":"POST",
"formats":"mp4,hls",
"extParam":{
"startTime":"00:00:00",
"endTime":"10:00:10"
},
"dstDir":"60/1465695/vod/2017/0323",
"rates":"400,800",
"dstBucket":"trans-test",
"attach":{
"path":"/trans-test/82_20170330173100.png",
"position":0
},
"type":"avop"
}
}
请求任务返回数据结构:
{
code:0, //状态码 0:成功 1:失败
desc:"success",
taskId:"07e589adf3da4512acaf7864a388e8f6"
}