ops参数格式

音视频处理

示例:
1.将原文件转换为音频码率64k,视频比特率128k的flv格式文件

  1. avthumb/flv/ab/64k/vb/128k|saveas/YnVja2V0OmtleQ==

说明:

参数 必填 描述
<op> avthumb(操作类型-音视频处理)
<format> 输出的目标格式,支持mp4、flv等。
/ab/<BitRate> 音频码率,单位:比特每秒(bit/s),常用码率:64k,128k,192k,256k,320k等。
/aq/<AudioQuality> 音频质量,取值范围为0-9(mp3),值越小质量越高;10-500(aac),值越大质量越高。仅支持mp3和aac。不能与音频码率参数ab共用。
/ar/<SamplingRate> 音频采样频率,单位:赫兹(Hz)。
常用采样频率:8000,12050,22050,44100等。
注:flv只支持44100、22050、11025
/r/<FrameRate> 视频帧率,每秒显示的帧数,单位:赫兹(Hz)。
常用帧率:24,25,30等,一般用默认值。
/vb/<VideoBitRate> 视频比特率,单位:比特每秒(bit/s)。
常用视频比特率:128k,1.25m,5m等。
/vcodec/<VideoCodec> 视频编码方案,支持方案:libx264,libws265,libvpx,libtheora,libxvid等。同时支持copy参数,保持原有视频的编码方案。注:转码场景下,当vcodec指定视频分辨率时,vb也需要配置比特率,才可以成功转码,否则默认以原编码方式拷贝源视频。
/acodec/<AudioCodec> 音频编码方案,支持方案:libmp3lame,libfaac,libvorbis,libfdk_aac,opus等。同时支持copy参数,保持原有音频的编码方案
/subtitle/<EncodeEntryURI> 添加字幕,支持:srt格式字幕(uft-8编码)、带有字幕的mkv文件、embed(将原视频的字幕流嵌入目标视频)
其中:EncodeEntryURI用于指定空间名与资源名
/subtitleType/<subtitleType> 用于显式指定字幕添加操作的类型,subtitleType=1 代表添加软字幕;subtitleType=2 代表添加硬字幕;默认subtitleType=0,即原程序自动识别的方式
/ss/<SeekStart> 指定视频截取的开始时间,单位:秒。用于视频截取,从一段视频中截取一段视频。
/t/<Duration> 指定视频截取的长度,单位:秒。
/s/<Resolution> 指定视频分辨率,格式为 wxh 或者预定义值。例如:640x480。也支持百分比形式,如s=50%x30%,代表输出视频的宽和高分别是输入视频的宽和高的百分比。
/autoscale/<Autoscale> 配合参数/s/使用,指定为1时,把视频按原始比例缩放到/s/指定的矩形框内,0或者不指定会强制缩放到对应分辨率,可能造成视频变形。
/autofill/<Autofill> 配合参数/s/使用,指定为1时,把视频按原始比例缩放到/s/指定的矩形框内居中展示,上下、左右多出的部分填充黑边,0或者不指定会强制缩放到对应分辨率,可能造成视频变形。
/sar/<Sar> 像素宽高比,例如 1:1
/deinterlace/<Deinterlace> 对隔行视频做处理,1为隔行扫描改成逐行扫描,0为不处理,默认不处理
/GOPInterval/<GOPInterval> 指定关键帧时间间隔,单位为:ms。与参数g不能共用。
/stripmeta/<StripMeta> 是否清除文件的metadata,1为清除,0为保留。
/rotate/<Degree> 指定顺时针旋转的度数,可取值为90、180、270、auto,默认为不旋转。
/wmImage2/<Encode(<bucket1>:<key1>,<bucket2>:<key2>...)> 图片&视频水印列表,采用“,”分隔多个水印图片路径,需要经过URL安全的Base64编码。
/wmGravity/<Gravity1>,<Gravity2>... 图片&视频水印位置列表,参见视频偏移参数表。采用“,”分隔多个水印位置。
/wmauto/<Wmauto> 根据视频转码分辨率变化自适应缩放图片&视频水印,为1则若转码有进行分辨率操作,则图片&视频水印进行自适应缩放,否则为原图片&视频水印大小。
/wmInterval/<WmInterval> 发生图片&视频水印变换的视频文件时间间隔,单位是:秒。
/wmWidth/<WmWidth1>,<WmWidth2>... 图片&视频水印的分辨率宽。可以是像素或者百分比。其中百分代表水印图片占用输出视频画面大小的百分比。
例如:wmWidth=50%&wmHeight=20%代表水印大小宽度为输出画面的一半,高度为输出画面的1/5。wmWidth=40&wmHeight=60代表水印大小分辨率为40x60,以像素为单位。特殊说明:当wmWidth或者wmHeight的值为0或者小于0时,代表自适应;当wmWidth和wmHeight两个元素都为0或者负值时,代表对于这个水印,不启用设置分辨率的功能。
/wmHeight/<WmHeight1>,<WmHeight2>... 图片&视频水印分辨率高。可以是像素或者百分比。举例和说明见wmWidth参数。
/wmDissolve/<alpha1>,<alpha2>... 图片&视频水印透明度,支持变换,数字类型。范围为[0,100]。其中100为不透明,0为全透明。当超过这个范围时,自动被限制到这个范围。比如-4变成0,120变成100。默认值:100
/multiConvertTime/<ConvertTime1>,<ConvertTime2>... 开始发生水印变换的视频文件时间列表,采用“,”分隔,单位是:秒。适用于水印变换时间间隔不定的场景,与wmInterval不共用
/wmdx/<Wmdx1>,<Wmdx2>... 用于对视频图片水印位置在偏移列表的基础上做横向微调,当值为正数时则向右偏移,反之向左。指定该参数时,wmGravity为必填,且参数个数与wmGravity保持一致。
/wmdy/<Wmdy1>,<Wmdy2>... 用于对视频图片水印位置在偏移列表的基础上做纵向微调,当值为正数时则向下偏移,反之向上。指定该参数时,wmGravity为必填,且参数个数与wmGravity保持一致。
/wmText/Encode(<Text1>),Encode(<Text2>)... 文字列表,若需要支持变换,不同于图片/视频水印,文字水印需要每串文字先进行URL安全的Base64编码后,再用逗号连接到一块(考虑到文字包含逗号)。中文需要是UTF-8编码,否则可能显示乱码。
/wmFont/<Encode(<Color1>,<Color2>,<Color3>...)> 文字水印字体名字,若需要支持变换,字体名字先用逗号连接字体名字列表,再URL安全的Base64编码。字体名字只能包含数字、大小写字母、空格和减号“-”。
/wmFontColor/<Encode(<Font1>,<Font2>,<Font3>...)> 文字水印字体颜色,若需要支持变换,字体颜色先用逗号连接,再URL安全的Base64编码。其中每一项颜色是形如0xrrggb或&Hrrggbb的字符串(大小写不敏感),分别代表颜色RGB分量,也可以省略0x或&H前缀。颜色格式需要正确。默认值:0xffffff,即白色
/wmFontSize/<size1>,<size2>... 文字水印字体大小,支持变换。整数类型,整数后面可加一个百分号。可以有两种形式,即像素和百分比形式。当数字后面有百分号时,是指字体占输出画面高度的百分比;反之为绝对像素大小。比如10代表10个像素高,而10%代表字体高度为输出画面高度10%。当为像素时,需要在[5,2160]范围内。当为百分比时,需要在(0,100%]范围内。默认值:6%
/wmFontDissolve/<alpha1>,<alpha2>... 文字水印文字透明度,支持变换,数字类型。范围为[0,100]。其中100为不透明,0为全透明。当超过这个范围时,不会报错,自动被限制到这个范围。比如-4变成0,120变成100。默认值:100
/wmFontBorderWidth/<w1>,<w2>... 文字水印字体描边,支持变换,整数类型。小于或等于0为不描边;否则为描边。默认值:0
/wmFontBorderColor/<Encode(<Color1>,<Color2>,<Color3>...)> 文字水印字体描边颜色,若需要支持变换,字体描边颜色先用逗号连接,再URL安全的Base64编码,格式同wmFontColor。默认值:0x000000,即黑色
/wmTextGravity/<gravity1>,<gravity2>... 文字水印文字位置,字符串类型,大小写不敏感,若需要支持位置变换,预设位置以逗号分割。格式同wmGravity。必须是9个预设值之一。默认值:top_right
/wmtextdx/<dx1>,<dx2>... 文字水印文字位置预设基础上的水平偏移,支持变换,整数类型。格式和含义类似wmdx。默认值:0
/wmtextdy/<dy1>,<dy2>... 文字水印文字位置预设基础上的竖直偏移,支持变换,整数类型。格式和含义类似wmdy。默认值:0
/wmTextInterval/<interval1>,<interval2>... 文字水印切换的时间间隔,支持变换,单位为秒,数字类型。格式和含义类似wmInterval.需要大于或等于1。
/wmFontBold/<b1>,<b2>... 文字水印字体是否粗体,支持变换,整数类型。0代表文字不使用粗体。非0代表使用粗体。默认值:0
/writeXing/<Xing> 转码成mp3时是否写入xing header,默认1写入,写入会导致 file,afinfo 等命令识别出错误的码率。好处是在需要音频时长、帧数的时候只需要获取header。
/an/<AudioNo> 是否去除音频流,0为保留,1为去除。默认值为0。
/vn/<VideoNo> 是否去除视频流,0为保留,1为去除。默认值为0。
/vprofile/<VideoProfile> 设置视频的profile等级,例如:baseline,main,high,high10,high422,high444等
/aprofile/<AudioProfile> 设置音频参数,libfaac类型,如aac_main aac_low;libfdk_aac类型, aac_low aac_he aac_he_v2 。默认为aac_lc。例如:avthumb/mp4/acodec/libfdk_aac/aprofile/aac_he
/level/<BitTorrentLevel> 设置比特流的Level,取值范围1.0-5.1。用来告诉解码器需要支持的什么级别的兼容性(视频编码器为libx264才有效)
/crf/<CRF> 指定恒定质量模式(视频编码器为libx264才有效);取值范围0-51,数值越大画质越差,建议取值[18,28]。
/maxrate/<Maxrate> 动态码率下限定最大码率,如1000k
注:该参数需要和crf参数一起使用才有效。使用该参数时,必须指定bufsize参数
/bufsize/<Bufsize> 编码缓冲大小,和maxrate一起使用,如1000k
/delogo/<x:y:w:h,x:y:w:h> 指定区域模糊处理,x为横向坐标,y为纵向坐标,以左上角为原点,向右为正,向左为负,向下为正,向上为负,单位像素。w是宽,h是高。多个位置逗号隔开。参数顺序固定,默认为0。
/ac/<AC> <数值>设定声道数,其中:1就是单声道,2就是立体声
/moovToFront/<MoovToFront> 将mp4文件的元信息放到头部。默认值为0,即不调整元信息的位置,1为调整。
/gravity/<Gravity> 参看视频偏移参数表,只影响其后的裁剪偏移参数,缺省为左上角(TOP_LEFT)。
/vcrop/<Vcrop> 参看视频裁剪操作参数表,缺省为不裁剪。
/reverse/<reverse> 是否逆序,1表示逆序,0表示不逆序,默认不逆序。注: 每段要逆序的音视频时长最多不超过5分钟。
/speedup/<speedup> 指定播放速度,取值大于0小于1表示降低播放速度,数值越小,播放速度越慢;大于1表示加快播放速度,数值越大播放速度越快;1表示播放速度不变。 speedup取值范围:慢速范围(0,1),快速范围(1,10)
/seiKeep/<seiKeep> 转码时,是否保留SEI,0为不保留,1为保留。默认值为0。 特别地,当仅做转封装处理时,SEI都默认保留
/map/<map> 设置输入流映射至输出。默认只取音视频第一路流。 -map 0表示将输入文件的所有流映射至输出。对于提取字幕操作,例map=0:s:0,第一位0表示输入的第一个文件;第二位s表示提取类型为字幕;第三位0表示字幕流索引号,从0开始,即提取第一个字幕流。
/drmContentId/<drmContentId> 用于DRM加密。内容注册的文件唯一标识符,最大支持500个字符,且不能以/作为开头和结尾,不允许使用以下字符 ^*()\ \+=[]“'<>
/drmSystem/<drmSystem> 用于DRM加密。标识DRM服务系统,当前支持取值为playready、widevine、fairplay,且只支持小写。
/nbhd/<nbhd> 是否开启智控高清,0为不开启,1为开启。默认值为0。
/vbRatio/<vbRatio> 视频比特率的系数形式:以输入视频码率为基数乘以改系数值作为输出视频比特率的设置,取值范围(0-15],支持小数形式。
备注:取值为0或大于15则返回报错。
当vbRatio计算得出视频比特率值超50Mbps时,判断为异常情况,此时参数不生效。
vbRatio 与 vb 同时配置时,以vbRatio配置为准
/hilitename/<hilitename> 设置输入视频的游戏类型并且进行"精彩集锦",目前仅支持PUBG、ALL等。 备注:
1"精彩集锦"是指,智能识别出游戏里的精彩片段,然后将精彩片段集合在一起,生成一个集锦视频。
2 pubg表示《绝地求生》,ALL表示识别所有支持的游戏类型。
/hiliteM/<hiliteM> 指定精彩片段前段时长,即识别到精彩画面后截取画面之前多长时间的片段,单位为秒,默认值为10。
/hiliteN/<hiliteN> 指定精彩片段后段时长,即识别到精彩画面后截取画面之后多长时间的片段,单位为秒,默认值为3。
/wsaf/<wsaf> 去伪影,value目前仅支持average,其他值非法。
/wssr/<wssr> 超分辨率倍数,目前支持放大1-3倍,即value=1,2,3 ,其他值非法。
/ivsr/<ivsr> 超分辨率的倍数,目前ivsr仅支持2或者3。
/write_id3v2/<write_id3v2> 表示转码成aac时是否写入源文件中id3的v2格式的frame到输出文件,1写入;0或未配置不写入。
/encrypt/<encrypt> 指定截取视频的时刻,单位:秒。
|saveas/<Encode(bucket:filekey)> 视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件

视频截图

示例:
1.截取视频第10秒的文件,保存为jpg文件

  1. vframe/jpg/offset/10|saveas/YnVja2V0OmtleQ==

说明:

参数 必填 描述
<op> vframe(操作类型-视频截图)
<format> 输出的目标格式,支持jpg、png、gif、webp等。
/offset/<Second> 指定截取视频的时刻,单位:秒。当指定interval、offsets、vframeN截多张图或雪碧图时,该参数非必填。
特别地,
1. 当指定interval参数截多张图或雪碧图时,此参数为起始截取时刻;
2. 当指定format为gif时,与t参数共用,此参数为起始截取时刻
/mode/<Mode> 缩放模式,有如下定义:
mode=1 限定缩略图的宽最少为,高最少为,进行等比缩放,居中裁剪。转后的缩略图通常恰好是<width>x<height>的大小(有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分)。如果只指定width参数或只指定height参数,代表宽最少为<width>或高最少为<height>的等比缩放。
mode=2 限定缩略图的宽度最多为<width>,高度最多为<height>,进行等比缩放,不裁剪。如果只指定width参数则表示限定宽度(高度自适应),只指定height参数则表示限定高度(宽度自适应)。
mode=3 限定缩略图的宽最少为<width>,高最少为<height>,进行等比缩放,不裁剪。
/w/<Width> 缩略图宽度,单位:像素(px),取值范围为1-1920。也支持百分比的形式,如w=50%&h=80%,代表输出截图的宽和高分别是输入视频的宽和高的百分比。
/h/<Height> 缩略图高度,单位:像素(px),取值范围为1-1080。也支持百分比的形式,如w=50%&h=80%,代表输出截图的宽和高分别是输入视频的宽和高的百分比。
/t/<Duration> 指定截取视频为GIF图片的时长,单位:秒。默认为5s
/r/<FrameRate> 指定截取视频为GIF图片的帧率,单位:fps。默认为源视频帧率(GIF图片的帧率最大不会超过源视频帧率)。使用建议:配置小帧率,缩小GIF图片文件大小
/rotate/<Degree> 指定顺时针旋转的度数,可取值为90、180、270、auto,默认为不旋转。
/autofill/<Autofill> 配合参数/w/和/h/一起使用,指定为1时,把图片按原始比例缩放到/w/和/h/指定的矩形框内,空隙的部分以黑色填充,0或者不指定会强制缩放到对应分辨率,可能造成视频变形。指定autofill参数时,不能与mode参数一起共用,且/w/和/h/都需要指定
/offsets/<VframeList> 指定截取多张视频图片,单位:秒。格式:指定多张不同秒的图,用:间隔。例如,1:3:10:20。
注:所有截图会统一放入一个zip文件中。当saveas参数指定为images:a.zip时,zip文件名为a.zip; 截图文件命名规则为序列号的形式,如:a_00001.jpg、a_00002.jpg。
/vframeN/<VframeN> 指定平均截图的张数,范围是1,2,3,4等。
注:所有截图会统一放入一个zip文件中。当saveas参数指定为images:a.zip时,zip文件名为a.zip;截图文件命名规则为序列号的形式,如:a_00001.jpg、a_00002.jpg。
/interval/<Interval> 指定连续截图的时间间隔,单位:秒。
注:所有截图会统一放入一个zip文件中。当saveas参数指定为images:a.zip时,zip文件名为a.zip;截图文件命名规则为:a_00001.jpg,依次类推。
/gif_interval/<Gif_interval> 表示gif循环播放的间隔时长,单位:秒。默认间隔2s。
/isZip/<IsZip> 指定offsets、vframeN、interval的输出文件是否为zip包。0为不为zip包,1为zip包。默认为1。
/sprite/<Sprite> 拼图规格,如4x5,表示将连续截取的图片拼接为4行5列的一张大拼图。
该参数需要和interval、offsets、vframeN相关参数一起使用才有效。gif格式不与sprite参数共用。
当saveas参数指定为images:a.zip时,拼图文件命名规则为:a_0000x.jpg;只生成了一个拼图时,命名为a_00001.jpg。如果有多个拼图文件,则命名为a_00001.jpg、a_00002.jpg、a_00003.jpg,依次类推。
/reverse/<reverse> 是否逆序,1表示逆序,0表示不逆序,默认不逆序。注:每段要逆序的音视频时长最多不超过5分钟。
/speedup/<speedup> 指定播放速度,取值大于0小于1表示降低播放速度,数值越小,播放速度越慢;大于1表示加快播放速度,数值越大播放速度越快。speedup取值范围:慢速范围(0.1,1),快速范围(1,10)。
/contentDetect/<ContentDetect> 内容鉴定,当前支持:
imagePorn-图片鉴黄, imageTerror-图片鉴恐, imagePolitical-政治人物识别
注:建议图片等比例压缩至最短边为256px即可
/detectNotifyURL/<DetectNotifyURL> 接收鉴定结果的通知地址,要求必须是公网URL地址,能正常响应HTTP/1.1 200 OK,该地址需要进行Url Encode编码后,再经过URL安全的Base64编码。如该参数未配置,则鉴定结果不通知。通知内容详见鉴定通知数据内容说明
/detectNotifyRule/<DetectNotifyRule> 鉴定通知规则设置,决定通知的鉴定结果。需经过URL安全的Base64编码
all 全部通知
porn 通知涉黄的图片
sexy 通知性感图片
normal 通知正常图片
exception 通知鉴定异常的图片
terror 通知暴恐图片(鉴定类型为imageTerror时才生效)
political 通知识别为政治人物的图片(鉴定类型为imagePolitical时才生效)
参数可以相互组合,以分号间隔
例如:
<1>Encode(all)即通知所有结果
<2>Encode(porn;exception)即类型为黄图、鉴定异常的图片会进行通知
备注:该参数不设置,则不通知客户
|saveas/<Encode(bucket:filekey)> 视频截图另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值。

音视频切片

示例:
1.将原文件转换为m3u8格式文件

  1. avthumb/m3u8|saveas/YnVja2V0OmtleQ==

2.使用HLS预设集video_16x9_150k

  1. avthumb/m3u8/preset/video_16x9_150k|saveas/YnVja2V0OmtleQ==

说明:

参数 必填 描述
<op> avthumb(操作类型-音视频处理)
<format> 输出的目标格式,即m3u8。
/segtype/ 生成的DASH文件格式,值域为{mp4,m4s},默认不配和填写其他值的情况下,输出.m4s
/segtime/<SegSeconds> 用于定义每一小段音/视频流的播放时长,单位:秒,取值范围1-120的整数。
注:以下为未设置该参数,默认取值场景说明:
1、输入为非m3u8格式,默认值为10秒;
2、输入为m3u8格式,未设置转码参数,仅对m3u8文件进行文本处理;
3、输入为m3u8格式,设置了转码参数,自动计算切片时长
/hlsKey/<HlsKey> 指定使用AES-128加密视频时使用的key,为保证安全,该参数值需要进行RSA加密。
1、key需要先转换成16进制的ascii码形式
2、RSA加密使用OAEP填充
3、需要经过URL安全的Base64编码
/hlsKeyUrl/<HlsKeyUrl> 获取hlsKey的URL,请将该URL使用URL安全的Base64编码后再填入参数中(该URL会写入m3u8文件内容的#EXT-X-KEY标签中)
/hlskeygen/<hlskeygen> 用于指定是否生成 key 文件, 1 为生成 key 文件并上传, 0 为不生成。默认不生成。
/hlssk/<hlssk> RSA私钥文件(PEM格式),需要经过URL安全的Base64编码。
/preset/<Preset> HLS预设集(Preset)名称。
/fastStartSeg/<FastStartSeg> 用于定义在m3u8切片的前M个ts片的时长为N秒,参数格式为MxNs。
例如:5x3s表示前5个ts片的切片时长为3秒
/ab/<BitRate> 音频码率,单位:比特每秒(bit/s)。常用码率:64k,128k,192k,256k,320k等。
/aq/<AudioQuality> 音频质量,取值范围为0-9(mp3),值越小质量越高;10-500(aac),值越大质量越高。仅支持mp3和aac。不能与上述码率参数共用。
/ar/<SamplingRate> 音频采样频率,单位:赫兹(Hz),常用采样频率:8000,12050,22050,44100等。(flv只支持44100、22050、11025)
/r/<FrameRate> 视频帧率,每秒显示的帧数,单位:赫兹(Hz),常用帧率:24,25,30等,一般用默认值。
/vb/<VideoBitRate> 视频比特率,单位:比特每秒(bit/s),常用视频比特率:128k,1.25m,5m等。
/vcodec/<VideoCodec> 视频编码方案,支持方案:libx264,libvpx,libtheora,libxvid等。注:转码场景下,当 vcodec 指定视频分辨率时,vb也需要配置比特率,才可以成功转码,否则默认以原编码方式拷贝源视频。
/acodec/<AudioCodec> 音频编码方案,支持方案:libmp3lame,libfaac,libvorbis,opus等。
/subtitle/<EncodeEntryURI> 添加字幕,支持:srt格式字幕(uft-8编码)、带有字幕的mkv文件、embed(将原视频的字幕流嵌入目标视频)
其中:EncodeEntryURI用于指定空间名与资源名
/subtitleType/<subtitleType> 用于显式指定字幕添加操作的类型,subtitleType=1 代表添加软字幕;subtitleType=2 代表添加硬字幕;默认subtitleType=0,即原程序自动识别的方式
/ss/<SeekStart> 指定视频截取的开始时间,单位:秒。用于视频截取,从一段视频中截取一段视频。
/t/<Duration> 指定视频截取的长度,单位:秒。用于视频截取,从一段视频中截取一段视频。
/s/<Resolution> 指定视频分辨率,格式为 wxh 或者预定义值。例如:640x480。也支持百分比形式,如s=50%x30%,代表输出视频的宽和高分别是输入视频的宽和高的百分比。
/autoscale/<Autoscale> 配合参数/s/使用,指定为1时,把视频按原始比例缩放到/s/指定的矩形框内,0或者不指定会强制缩放到对应分辨率,可能造成视频变形。
/autofill/<Autofill> 配合参数/s/使用,指定为1时,把视频按原始比例缩放到/s/指定的矩形框内居中展示,上下、左右多出的部分填充黑边,0或者不指定会强制缩放到对应分辨率,可能造成视频变形。
/sar/<Sar> 像素宽高比,例如 1:1
/deinterlace/<Deinterlace> 对隔行视频做处理,1为隔行扫描改成逐行扫描,0为不处理,默认不处理
/GOPInterval/<GOPInterval> 指定关键帧时间间隔,单位为:ms。与参数g不能共用。
/stripmeta/<StripMeta> 是否清除文件的metadata,1为清除,0为保留。
/rotate/<Degree> 指定顺时针旋转的度数,可取值为90、180、270、auto,默认为不旋转。
/delogo/<x:y:w:h,x:y:w:h> 指定区域模糊处理,x为横向坐标,y为纵向坐标,以左上角为原点,向右为正,向左为负,向下为正,向上为负,单位像素。w是宽,h是高。多个位置逗号隔开。参数顺序固定,默认为0。
/wmImage2/<Encode(<bucket1>:<key1>,<bucket2>:<key2>...)> 图片&视频水印列表,采用“,”分隔多个水印图片路径,需要经过URL安全的Base64编码。
/wmGravity/<Gravity1>,<Gravity2>... 图片&视频水印位置列表,参见视频偏移参数表。采用“,”分隔多个水印位置。
/wmauto/<Wmauto> 根据视频转码分辨率变化自适应缩放图片&视频水印,为1则若转码有进行分辨率操作,则图片&视频水印进行自适应缩放,否则为原图片&视频水印大小。
/wmInterval/<WmInterval> 发生图片&视频水印变换的视频文件时间间隔,单位是:秒。
/wmWidth/<WmWidth1>,<WmWidth2>... 图片&视频水印的分辨率宽。可以是像素或者百分比。其中百分代表水印图片占用输出视频画面大小的百分比。
例如:wmWidth=50%&wmHeight=20%代表水印大小宽度为输出画面的一半,高度为输出画面的1/5。wmWidth=40&wmHeight=60代表水印大小分辨率为40x60,以像素为单位。特殊说明:当wmWidth或者wmHeight的值为0或者小于0时,代表自适应;当wmWidth和wmHeight两个元素都为0或者负值时,代表对于这个水印,不启用设置分辨率的功能。
/wmHeight/<WmHeight1>,<WmHeight2>... 图片&视频水印分辨率高。可以是像素或者百分比。举例和说明见wmWidth参数。
/wmDissolve/<alpha1>,<alpha2>... 图片&视频水印透明度,支持变换,数字类型。范围为[0,100]。其中100为不透明,0为全透明。当超过这个范围时,自动被限制到这个范围。比如-4变成0,120变成100。默认值:100
/multiConvertTime/<ConvertTime1>,<ConvertTime2>... 开始发生水印变换的视频文件时间列表,采用“,”分隔,单位是:秒。适用于水印变换时间间隔不定的场景,与wmInterval不共用
/wmdx/<Wmdx1>,<Wmdx2>... 用于对视频图片水印位置在偏移列表的基础上做横向微调,当值为正数时则向右偏移,反之向左。指定该参数时,wmGravity为必填,且参数个数与wmGravity保持一致。
/wmdy/<Wmdy1>,<Wmdy2>... 用于对视频图片水印位置在偏移列表的基础上做纵向微调,当值为正数时则向下偏移,反之向上。指定该参数时,wmGravity为必填,且参数个数与wmGravity保持一致。
/wmText/Encode(<Text1>),Encode(<Text2>)... 文字列表,若需要支持变换,不同于图片/视频水印,文字水印需要每串文字先进行URL安全的Base64编码后,再用逗号连接到一块(考虑到文字包含逗号)。中文需要是UTF-8编码,否则可能显示乱码。
/wmFont/<Encode(<Color1>,<Color2>,<Color3>...)> 文字水印字体名字,若需要支持变换,字体名字先用逗号连接字体名字列表,再URL安全的Base64编码。字体名字只能包含数字、大小写字母、空格和减号“-”。
/wmFontColor/<Encode(<Font1>,<Font2>,<Font3>...)> 文字水印字体颜色,若需要支持变换,字体颜色先用逗号连接,再URL安全的Base64编码。其中每一项颜色是形如0xrrggb或&Hrrggbb的字符串(大小写不敏感),分别代表颜色RGB分量,也可以省略0x或&H前缀。颜色格式需要正确。默认值:0xffffff,即白色
/wmFontSize/<size1>,<size2>... 文字水印字体大小,支持变换。整数类型,整数后面可加一个百分号。可以有两种形式,即像素和百分比形式。当数字后面有百分号时,是指字体占输出画面高度的百分比;反之为绝对像素大小。比如10代表10个像素高,而10%代表字体高度为输出画面高度10%。当为像素时,需要在[5,2160]范围内。当为百分比时,需要在(0,100%]范围内。默认值:6%
/wmFontDissolve/<alpha1>,<alpha2>... 文字水印文字透明度,支持变换,数字类型。范围为[0,100]。其中100为不透明,0为全透明。当超过这个范围时,不会报错,自动被限制到这个范围。比如-4变成0,120变成100。默认值:100
/wmFontBorderWidth/<w1>,<w2>... 文字水印字体描边,支持变换,整数类型。小于或等于0为不描边;否则为描边。默认值:0
/wmFontBorderColor/<Encode(<Color1>,<Color2>,<Color3>...)> 文字水印字体描边颜色,若需要支持变换,字体描边颜色先用逗号连接,再URL安全的Base64编码,格式同wmFontColor。默认值:0x000000,即黑色
/wmTextGravity/<gravity1>,<gravity2>... 文字水印文字位置,字符串类型,大小写不敏感,若需要支持位置变换,预设位置以逗号分割。格式同wmGravity。必须是9个预设值之一。默认值:top_right
/wmtextdx/<dx1>,<dx2>... 文字水印文字位置预设基础上的水平偏移,支持变换,整数类型。格式和含义类似wmdx。默认值:0
/wmtextdy/<dy1>,<dy2>... 文字水印文字位置预设基础上的竖直偏移,支持变换,整数类型。格式和含义类似wmdy。默认值:0
/wmTextInterval/<interval1>,<interval2>... 文字水印切换的时间间隔,支持变换,单位为秒,数字类型。格式和含义类似wmInterval.需要大于或等于1。
/wmFontBold/<b1>,<b2>... 文字水印字体是否粗体,支持变换,整数类型。0代表文字不使用粗体。非0代表使用粗体。默认值:0
/an/<AudioNo> 是否去除音频流,0为保留,1为去除。默认值为0。
/vn/<VideoNo> 是否去除视频流,0为保留,1为去除。默认值为0。
/vprofile/<VideoProfile> 设置视频参数,例如baseline,main,high,high10,high422,high444等
/aprofile/<AudioProfile> 设置音频参数,libfaac类型,如aac_main aac_low;libfdk_aac类型, aac_low aac_he aac_he_v2 。默认为aac_lc。例如:avthumb/mp4/acodec/libfdk_aac/aprofile/aac_he
/level/<BitTorrentLevel> 设置比特流的Level,取值范围1.0-5.1。默认4.0。用来告诉解码器需要支持的什么级别的兼容性(视频编码器为libx264才有效)
/crf/<CRF> 指定恒定质量模式(视频编码器为libx264才有效);取值范围0-51,数值越大画质越差,建议取值[18,28]。
/maxrate/<maxrate> 指定最大码率,如1000k
注:该参数需要和crf参数一起使用才有效。使用该参数时,必须指定bufsize参数
/bufsize/<Bufsize> 指定buffer的大小,如1000k
/ac/<AC> <数值>设定声道数,其中:1就是单声道,2就是立体声
/pat_period/<Pat_period> 用于定义PAT\PMT间隔时间,指定参数最小为1,单位:秒。
/envBandWidth/<EnvBandWidth> 不同码流切换的带宽标准,采用符号":"分隔多个网络带宽,个数范围[2,5],取值范围[50000,30000000],单位是b/s。例如50000:150000:500000。
注:HLS格式生效,DASH格式配置无效。个数与存在的multi参数值个数需要保持一致,建议与设置的码率值接近,带宽值采用升序方式。
/multiAb/<MultiAb> 与ab参数不共存,单位:比特每秒(bit/s),采用符号":"分隔多个音频码率,HLS个数范围[2,5],DASH个数范围[1,5],例如64k:128k:256k。
注:码率个数与其他存在的multi参数值个数需要保持一致。
/multiVb/<MultiVb> 与vb参数不共存,单位:比特每秒(bit/s),采用符号":"分隔多个视频码率,HLS个数范围[2,5],DASH个数范围[1,5],例如128k:600k:125m。
注:码率个数与其他存在的multi参数值个数需要保持一致。
/multiResolution/<MultiResolution> 与resolution参数不共存,分辨率格式为wxh,采用符号":"分隔多个视频分辨率,HLS个数范围[2,5],DASH个数范围[1,5],例如320x240:640x480:1080x720。
注:会改变视频的长宽比(DAR),分辨率个数与其他存在的multi参数值个数需要保持一致。
/addlivetime/<addlivetime> 点播flv转hls时是否获取onMetaData中的currenttime并将该时间转为m3u8的EXT-X-PROGRAM-DATE-TIME格式写入文件,1表示启用,0表示不启用,默认不启用。
/duration_flag/<Duration_Flag> 1)用于WCT在m3u8文件添加自定义标签,名为: #EXT-X-FILEDURATION,单位:秒。 2)EXT-X-FILEDURATION为所有ts文件时长之和: a)该参数可选值为0和1。 b)默认为0;1为添加该标签。
/reverse/<reverse> 是否逆序,1表示逆序,0表示不逆序,默认不逆序。注: 每段要逆序的音视频时长最多不超过5分钟。
/speedup/<speedup> 指定播放速度,取值大于0小于1表示降低播放速度,数值越小,播放速度越慢;大于1表示加快播放速度,数值越大播放速度越快;1表示播放速度不变。 speedup取值范围:慢速范围(0,1),快速范围(1,10)
/seiKeep/<seiKeep> 转码时,是否保留SEI,0为不保留,1为保留。默认值为0。 特别地,当仅做转封装处理时,SEI都默认保留。
/map/<map> 设置输入流映射至输出。默认只取音视频第一路流。-map 0表示将输入文件的所有流映射至输出。对于提取字幕操作,例map=0:s:0,第一位0表示输入的第一个文件;第二位s表示提取类型为字幕;第三位0表示字幕流索引号,从0开始,即提取第一个字幕流。
/nbhd/<nbhd> 是否开启智控高清,0为不开启,1为开启。默认值为0。
/encrypt/<encrypt> 指定截取视频的时刻,单位:秒。
/encodedurl/<encodedurl1,encodedurl2,...,encodedurlN> 指定需要生成多码率的文件名。需要进行URL安全的Base64编码;多个文件编码后采用","分隔;所有文件必须属于同一个空间
|saveas/<Encode(bucket:filekey)> 转码后文件另存为指定文件,参数中需要填入"空间:文件名"URL安全的Base64编码后的值

HLS预设集

音频/视频 预设集 说明
音频 audio_32k 码率为32k的音频。
音频 audio_48k 码率为48k的音频
音频 audio_64k 码率为64k的音频。
视频 video_16x9_150k 码率为150K,长宽比为16x9。分辨率400x224
视频 video_16x9_240k 码率为240K,长宽比为16x9。分辨率400x224
视频 video_16x9_440k 码率为440K,长宽比为16x9。分辨率400x224
视频 video_16x9_640k 码率为640K,长宽比为16x9。分辨率400x224
视频 video_4x3_150k 码率为150K,长宽比为4x3。分辨率400x300
视频 video_4x3_240k 码率为240K,长宽比为4x3。分辨率400x300
视频 video_4x3_440k 码率为440K,长宽比为4x3。分辨率400x300
视频 video_4x3_640k 码率为640K,长宽比为4x3。分辨率400x300
视频 video_150k 码率为150K,长宽比沿用源视频设置。
视频 video_240k 码率为240K,长宽比沿用源视频设置。
视频 video_440k 码率为440K,长宽比沿用源视频设置。
视频 video_640k 码率为640K,长宽比沿用源视频设置。
视频 video_1000k 码率为1000K,长宽比沿用源视频设置。
视频 video_1500k 码率为1500K,长宽比沿用源视频设置。

音视频拼接

示例:
1.将原文件,文件fileA, fileB, fileC拼接为flv格式文件

  1. avconcat/flv/ZmlsZUE=/ZmlsZUI=/ZmlsZUM=|saveas/YnVja2V0OmtleQ==

说明:

参数 必填 描述
<op> avconcat(操作类型-音视频拼接)
<format> 输出的目标格式,如mp4,flv,m3u8
/segtime/<Segtime> 输出目标格式为m3u8时,用来定义每一小段音/视频流的播放时长,单位:秒,取值范围1-120的整数。
注:以下为未设置该参数,默认取值场景说明:
1、输入包含非m3u8格式或者编码方案、分辩率、sar等音视频参数不一致,默认值为10秒;
2、输入皆为m3u8格式,未设置转码参数,仅进行m3u8文件的文本拼接;
3、输入皆为m3u8格式,设置了转码参数,自动计算切片时长
/concatorder/<Concatorder> 拼接文件的顺序,中间用-分割,如2-1-4-3
/ab/<BitRate> 音频码率,单位:比特每秒(bit/s)。常用码率:64k,128k,192k,256k,320k等。
/aq/<AudioQuality> 音频质量,取值范围为0-9(mp3),值越小质量越高;10-500(aac),值越大质量越高。仅支持mp3和aac。不能与上述码率参数共用。
/ar/<SamplingRate> 音频采样频率,单位:赫兹(Hz),常用采样频率:8000,12050,22050,44100等。(flv只支持44100、22050、11025)
/r/<FrameRate> 视频帧率,每秒显示的帧数,单位:赫兹(Hz),常用帧率:24,25,30等,一般用默认值。
/vb/<VideoBitRate> 视频比特率,单位:比特每秒(bit/s),常用视频比特率:128k,1.25m,5m等。
/vcodec/<VideoCodec> 视频编码方案,支持方案:libx264,libvpx,libtheora,libxvid等。注:转码场景下,当 vcodec 指定视频分辨率时,vb也需要配置比特率,才可以成功转码,否则默认以原编码方式拷贝源视频。
/acodec/<AudioCodec> 音频编码方案,支持方案:libmp3lame,libfaac,libvorbis等。
/s/<Resolution> 指定视频分辨率,格式为 wxh 或者预定义值。
/rotate/<Degree> 指定顺时针旋转的度数,可取值为90、180、270、auto,默认为不旋转。
/wmImage2/<Encode(<bucket1>:<key1>)> 水印图片地址,需要经过URL安全的Base64编码。
/moovToFront/<MoovToFront> 将mp4文件的元信息放到头部.默认值为0,即不调整元信息的位置,1为调整
/<encodedurl1>/<encodedurl2>/.../<encodedurlN> 指定需要拼接的文件名,需要作URL安全的Base64编码,多个文件编码后采用"/"分隔;所有文件必须属于同一个空间;最多支持5个文件
|saveas/Encode(<bucket:filekey>) 转码后文件另存为指定文件,参数中需要填入"空间:文件名"URL安全的Base64编码后的值。

获取专辑图片

示例:
1.获取专辑图片,保存为jpg格式文件

  1. getapic/jpg|saveas/YnVja2V0OmtleQ==

说明:

参数 必填 描述
<op> getapic(操作类型-获取MP3专辑图片)
<format> 图片的输出格式,如:jpg,png
|saveas/Encode(<bucket:filekey>) 提取的图片保存为指定文件,参数中需要填入"空间:文件名"URL安全的Base64编码后的值。

解压缩

示例:
1.解压zip格式文件,解压成功后删除原zip文件

  1. decompression/zip/crush/2|saveas/YnVja2V0OmtleQ==

说明:

参数 必填 描述
<op> decompression(操作类型-文件解压缩)
<format> 解压的文件格式,支持zip、tar、gzip、7z、rar
/dir/<encode(bucket:dir)> 解压文件到指定目录,参数中需要填入"空间:目录"URL安全的Base64编码后的值。默认以当前压缩包的目录进行解压缩
/crush/ 解压成功后的操作:
2-解压成功后删除压缩文件,不创建list文件
1-解压成功后删除压缩文件,保留list文件
0-解压成功后保留压缩文件,保留list文件
/p/ 指定解压文件时的密码,为保证安全,需要进行RSA加密:
1、RSA密钥对由客户提供,并将公钥告知云存储。
2、客户使用RSA私钥加密后再传递密文给云存储。
3、云存储收到密文后使用客户提供的公钥解密后,再用于压缩文件的解压。
4、该参数目前仅支持rar、zip格式的文件,其它格式会忽略该参数。
|saveas/Encode(<bucket:filekey>) 将解压缩生成的list保存为指定文件,参数中需要填入"空间:文件名"URL安全的Base64编码后的值。默认保存在当前压缩包的目录,命名为:随机数+时间戳+压缩包名.list

视频偏移参数表

参数 说明
TOP_LEFT 左上角为坐标原点,x轴从左到右,y轴从上到下。
TOP_CENTER 上部中间位置为坐标原点,x轴从左到右,y轴从上到下。
TOP_RIGHT 右上角位置为坐标原点,x轴从右到左,y轴从上到下,也是默认值。
CENTER_LEFT 左边缘中间位置为坐标原点,x轴从左到右,y轴从上到下。
CENTER 正中间位置为坐标原点,x轴从左到右,y轴从上到下。
CENTER_RIGHT 右边缘的中间位置为坐标原点,x轴从右到左,y轴从上到下。
BOTTOM_LEFT 左下角为坐标原点,x轴从左到右,y轴从下到上。
BOTTOM_CENTER 下边缘的中间为坐标原点,x轴从左到右,y轴从下到上。
BOTTOM_RIGHT 右下角坐标原点,x轴从右到左,y轴从下到上。

视频裁剪操作参数表

参数 说明
&vcrop=<Width>x 指定目标视频宽度,高度不变。取值范围 0-10000。
&vcrop=!{vcropSize}a<dx>a<dy> 相对于偏移锚点,向右偏移dx个像素,同时向下偏移dy 个像素。
&vcrop=x<Height> 指定目标视频高度,宽度不变。取值范围 0-10000。
&vcrop=<Width>x<Height> 同时指定目标视频宽高。取值范围 0-10000。