3.2 点播转码接口.md 3.49 KB

Edit Raw Blame History



点播视频转码URL接口


URL: http://transcode.cnlive.com/api/request


接口说明: 针对视讯云平台上传内容的转码服务


请求方式: 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"
}