文档中心

创建模板接口(Preset)

请求参数

参数名 类型 是否必须 描述
preset string 模板名称
presettype string 模板类型:固定值avop
param string 模板内容,请参考下面表格式
description string 模板描述

模板内容

每种任务的param内容不同,其内容与presettype对应。现阶段离线处理的业务功能,类型有以下几种:

1、avop                  转码、格式转换
2、avlogo              加水印
3、avm3u8              音视频切片
4、avsample            采样截图
5、avsnapshot          单张截图
6、avinfo              音视频信息获取

avop模板内容:

{
    "preset": "xxxx",
    "description": "xxxx",
    "presettype": "avop",
    "param":{
        //转码输出的封装格式:PackageFormat,如mp4,mkv等 type:string
        "f": "xxx",
        //智能转码 type:int
        //默认值:0,0支持小转大、1不支持小转大、2智能判断
        //视频判断参数:vr、vb、width、height
        //音频判断参数:暂不判断
        "intelligentSwitch":0,
        "AUDIO": {
            //音频码率 type:string
            //支持k、kb、m、mb 如:128k
            //取值范围 20000~320000
            "ab": "xxx",
            //音频采样频率 type:string
            //取值范围 8000~96000
            "ar": "xxx",
            //音频编码器 type:string
            //默认值: aac 支持:aac、mp3、copy 
            "acodec": "xxxx",
            //是否去除音频流  type:int
            //默认值:0
            "an": xxx
        },
        "VIDEO": {            
            //视频帧率 type:string
            //取值范围 1~60
            "vr": "xxx",
            //视频码率 type:string
            //支持k、kb、m、mb 如:400k
            //取值范围 100000~10000000
            "vb": "xxxx",
            //视频编码器 type:string
            //默认值: h264 支持:h264、h265、copy
            "vcodec": "xxxx",
            //视频分辨率 type:int
            //如果只指定任一,会按指定到值按原比例缩放
            "width": xxx,
            "height": xxx,
            //是否按原比例进行缩放  type:int
            //默认值:0
            "as": xxx,
            //设置输出视频短边,程序按照原始比例自动缩放 type:int
            //如果需要模板支持横竖屏视频自动判断转码,则设置该参数
            //该参数需要在as=1情况下使用
            "shortSide":360,
            //Rotate 指定视频顺时针旋转度数 type:string 
            //支持:0-360、auto
            "rotate": "xxxx",
            //是否去除视频流  type:int
            //默认值:0
            vn": xxx
        }
    }
}
</pre>

***avlogo模板内容:***
<pre>
{
    "preset": "xxxx",
    "presettype": "avlogo",
    "description": "xxxx",
    "param":{        
        //水印参数 type:array
        "IMAGE":[
            {                
                //水印图片地址(需要ks3的内网地址) type:string
                //如:http://ks3-cn-beijing-internal.ksyun.com/test/logo.png
                "logoUrl":"http://ks3-cn-beijing-internal.ksyun.com/{bucket_name}/{object_name}",
                // logoUrl与宽与高的偏移值,宽向右为正,高向下为正 type:int
                // 可选值,默认把pic放在左上角,offsetX=10,offsetY=10
                // 如果offsetX=-10,offsetY=10,则Pic放在视频右上角。
                "offsetX":10,
                "offsetY":10,
                // 该logoUrl最适合应用于哪种分辨率的视频上,shortSide指定加logo后的短边长度 type:int
                // 比如:640x360,360x640,短边都是360
                // 可选,如果不设置,disableScale=1
                "shortSide":360
            },{
                ...
            }
        ]
    }
}

avm3u8模板内容:

{
    "preset": "xxxx",
    "presettype": "avm3u8",
    "description": "xxxx",
    "param":{
        //每片的时长,单位为s type:int
        "hls_time":xxx,
        //是否清除文件的meta信息 默认:0 type:int
        "clearmeta":xxxx,
        //智能转码 type:int
        //默认值:0,0支持小转大、1不支持小转大、2智能判断
        //视频判断参数:vr、vb、width、height
        //音频判断参数:暂不判断
        "intelligentSwitch":0,
        "AUDIO": {
            //音频码率 type:string
            //支持k、kb、m、mb 如:128k
            //取值范围 20000~320000
            "ab": "xxx",
            //音频采样频率 type:string
            //取值范围 8000~96000
            "ar": "xxx",
            //音频编码器 type:string
            //默认值: aac 支持:aac、mp3、copy 
            "acodec": "xxxx",
            //是否去除音频流  type:int
            //默认值:0
            "an": xxx
        },
        "VIDEO": {            
            //视频帧率 type:string
            //取值范围 1~60
            "vr": "xxx",
            //视频码率 type:string
            //支持k、kb、m、mb 如:400k
            //取值范围 100000~10000000
            "vb": "xxxx",
            //视频编码器 type:string
            //默认值: h264 支持:h264、h265、copy
            "vcodec": "xxxx",
            //视频分辨率 type:int
            //如果只指定任一,会按指定到值按原比例缩放
            "width": xxx,
            "height": xxx,
            //是否按原比例进行缩放  type:int
            //默认值:0
            "as": xxx,
            //设置输出视频短边,程序按照原始比例自动缩放 type:int
            //如果需要模板支持横竖屏视频自动判断转码,则设置该参数
            //该参数需要在as=1情况下使用
            "shortSide":360,
            //Rotate 指定视频顺时针旋转度数 type:string 
            //支持:0-360、auto
            "rotate": "xxxx",
            //是否去除视频流  type:int
            //默认值:0
            vn": xxx
        }
    }
}

avsample模板内容:

{
    "preset": "xxxx",
    "presettype": "avsample",
    "description": "xxxx",
    "param":{
        //视频分辨率 type:int
        //如果只指定任一,会按指定到值按原比例缩放
        "width": xxx,
        "height": xxx,        
        //间隔,单位s
        "interval":xxx
    }
}

avsnapshot模板内容:

{
    "preset": "xxxx",
    "presettype": "avsnapshot",
    "description": "xxxx",
    "param":{        
        //视频分辨率 type:int
        //宽高必须全部设定,否则会按源分辨率生成截图 type:int
        "width": xxx,
        "height": xxx,
        //设置输出截图短边,程序按照原始比例自动缩放 type:int
        //如果需要模板支持横竖屏视频自动判断转码,则设置该参数
        //该参数优先级最高
        "shortSide":360
    }
}

avinfo模板内容:

{
    "preset": "xxxx",
    "presettype": "avinfo",
    "description": "xxxx",
    "param":{
        //avinfo无需参数
    }
}

返回数据

{
    "errNum":0,
    "errMsg":"success"
}