示例:
1.将原文件转换为音频码率64k,视频比特率128k的flv格式文件
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文件
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格式文件
avthumb/m3u8|saveas/YnVja2V0OmtleQ==
2.使用HLS预设集video_16x9_150k
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编码后的值 |
音频/视频 | 预设集 | 说明 |
---|---|---|
音频 | 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格式文件
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格式文件
getapic/jpg|saveas/YnVja2V0OmtleQ==
说明:
参数 | 必填 | 描述 |
---|---|---|
<op> | 是 | getapic(操作类型-获取MP3专辑图片) |
<format> | 是 | 图片的输出格式,如:jpg,png |
|saveas/Encode(<bucket:filekey>) | 否 | 提取的图片保存为指定文件,参数中需要填入"空间:文件名"URL安全的Base64编码后的值。 |
示例:
1.解压zip格式文件,解压成功后删除原zip文件
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。 |