CDN加速

API文档

更新时间:2022-06-23 14:08:20

Ops参数格式

音视频处理包含音视频转码音视频拼接视频截图获取专辑图片这四类的转码参数,具体如下:

一、音视频转码(avthumb)

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

avthumb/flv/ab/64k/vb/128k|saveas/YnVja2V0OmtleQ==
参数必填描述
<op>avthumb(操作类型-音视频处理)
<format>输出的目标格式,支持mp4、flv、m3u8、mpd等。
音频转码参数
/acodec/<AudioCodec>音频编码方案,支持方案:libmp3lame,libfaac,libvorbis,libfdk_aac,opus等。同时支持copy参数,保持原有音频的编码方案
/ab/<BitRate>音频码率,单位:比特每秒(bit/s),常用码率:64k,128k,192k,256k,320k等。
/ar/<SamplingRate>音频采样频率,单位:赫兹(Hz)。常用采样频率:8000,12050,22050,44100等。
注:flv只支持44100、22050、11025
/aq/<AudioQuality>音频质量,取值范围为0-9(mp3),值越小质量越高;10-500(aac),值越大质量越高。仅支持mp3和aac。不能与音频码率参数ab共用。
/ac/<AC><数值>设定声道数,其中:1就是单声道,2就是立体声
/aprofile/<AudioProfile>设置音频压缩特性参数,只针对libfaac类型,如aac_main aac_low;libfdk_aac类型, aac_low aac_he aac_he_v2 。默认为aac_lc。
/volume/<volumeadjustment>设置音频音量调节。在原音频基础上,支持按倍数调节以及按声音分贝调节。
倍数调节范围:0-2(0表示无声,1原声,2表示放大一倍,1.5表示音量放大为原来1.5倍);
按分贝调节:建议配置到 -10dB~10dB,负数表示音量降低,正数表示增加。配置过大将导致音频失真。
/loudnorm/<VolumeNormalization>设置音量归一化响度。单位为LUFS(Loudness Units relative to Full Scale)。范围为-70到-5。负数值越大,声音越小;负数值越小,声音越大。
注:输出视频的音频编码格式若为:
(1)eac3,必须配置ar参数,取值只能为:48000/44100/32000
(2)ac3,必须配置ar参数,取值只能为:48000/44100
暂不支持dts格式的编码,不建议同时使用volume参数
/write_id3v2/<write_id3v2>表示转码成aac时是否写入源文件中id3的v2格式的frame到输出文件,1写入;0或未配置不写入。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
视频转码参数
/vcodec/<VideoCodec>视频编码方案,支持方案:libx264,libws265,libvpx,libtheora,libxvid等。同时支持copy参数,保持原有视频的编码方案。注:转码场景下,当vcodec指定视频分辨率时,vb也需要配置比特率,才可以成功转码,否则默认以原编码方式拷贝源视频。
/s/<Resolution>指定视频分辨率,格式为 wxh 或者预定义值。
1. 正常缩放:设置宽和高,则按配置输出指定宽和高的视频。例如:640x480。若设置的分辨率高宽比和原视频分辨率不一致,则会出现拉伸变形的情况。
2. 按宽或高自适应比率输出:仅指定宽或者高,则输出会根据原视频的宽高比自适应缩放。
例如: 输入视频是1920x1080,分辨率配置为1280x-1或者-1x720,则输出视频分辨率均为1280x720。
/autoscale/<Autoscale>配合参数/s/使用。指定为1时,把视频按原始比例缩放到/s/指定的矩形框内;0或者不指定,会强制缩放到对应分辨率,可能造成视频变形。
例如:源是1920x1920,配置输出分辨率为1280x720,则:
1. autoscale=0:输出为指定的1280x720,拉伸变形;
2. autoscale=1:输出会按源视频比例(1:1)缩放成720x720。
/autofill/<Autofill>配合参数/s/使用,指定为1时,把视频按原始比例缩放到/s/指定的矩形框内居中展示,上下、左右多出的部分填充黑边,0或者不指定会强制缩放到对应分辨率,可能造成视频变形。
例如:源是1920x1920,配置输出分辨率为1280x720,则:autofill=1则输出为则指定的1280x720,实际画面大小为720x720,视频居中,两边填充黑边。
/sar/<Sar>像素宽高比,例如:1:1。此值优先级比分辨率高,即设置输出视频分辨率s=720*720,sar=1:2,则实际输出视频为720*1420。
/vb/<VideoBitRate>视频比特率,单位:比特每秒(bit/s)。常用视频比特率:128k,1.25m,5m等。
/vbRatio/<vbRatio>视频比特率的系数形式:以输入视频码率为基数乘以改系数值作为输出视频比特率的设置,取值范围(0-15],支持小数形式。
注:
(1) 取值为0或大于15则返回报错
(2) 当vbRatio计算得出视频比特率值超50Mbps时,判断为异常情况,此时参数不生效
(3) vbRatio 与 vb 同时配置时,以vbRatio配置为准
/r/<FrameRate>视频帧率,每秒显示的帧数,单位:赫兹(Hz)。常用帧率:24,25,30等,一般用默认值。
/rotate/<Degree>指定顺时针旋转的度数,可取值为90、180、270、auto,默认为不旋转。
/vprofile/<VideoProfile>设置视频压缩特性参数(CABAC、颜色采样数等等),baseline,main,high,high10,high422,high444。Profile越高,就说明采用了越高级的压缩特性。
/level/<BitTorrentLevel>设置比特流的Level,取值范围1.0-5.1。用来告诉解码器需要支持的什么级别的兼容性(视频编码器为libx264才有效)
/crf/<CRF>指定恒定质量模式(视频编码器为libx264才有效);取值范围0-51,数值越大画质越差,建议取值[18,28]。
/maxrate/<Maxrate>动态码率下限定最大码率,如1000k
注:该参数需要和crf参数一起使用才有效。使用该参数时,必须指定bufsize参数
/bufsize/<Bufsize>编码缓冲大小,和maxrate一起使用,如1000k
/GOPInterval/<GOPInterval>指定关键帧时间间隔,单位为:ms。不指定则智能按照画面情况选择,与参数g(即:每隔几帧插入关键帧)不能共用。
/deinterlace/<Deinterlace>对隔行视频做处理,参数:0、1、2、3。其中:
0-为不处理,默认不处理;
1-无脑去交错。不论视频是隔行扫描还是逐行扫描,都会进行去交错;
2-标准去交错。只有视频是隔行扫描,才会进行去交错
3-支持非标准去交错。即用ffmpeg自行生成的去交错,只有视频是隔行扫描才会处理
/stripmeta/<StripMeta>是否清除文件的metadata,1为清除,0为保留。
/seiKeep/<seiKeep>转码时,是否保留SEI,0为不保留,1为保留。默认值为0。 特别地,当仅做转封装处理时,SEI都默认保留
/delogo/<x:y:w:h,x:y:w:h>指定区域模糊处理,x为横向坐标,y为纵向坐标,以左上角为原点,向右为正,向左为负,向下为正,向上为负,单位像素。w是宽,h是高。多个位置逗号隔开。参数顺序固定,默认为0。
/reverse/<reverse>是否逆序,1表示逆序,0表示不逆序,默认不逆序。
备注:要逆序的音视频最多不超过5分钟。
/speedup/<speedup>指定播放速度,取值大于0小于1表示降低播放速度,数值越小,播放速度越慢;大于1表示加快播放速度,数值越大播放速度越快;1表示播放速度不变。
speedup取值范围:慢速范围 [0.1,1),快速范围(1,10],小数点不限制
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
转封装&音视频切片参数
/rename_by_key/<RenameByM3U8>设置ts或二级m3u8等文件名,按照一级m3u8的文件名生成。为1 表示开启,为0表示关闭,默认为0。只对format配置M3U8有效,且为avconcat跟avthumb 2个场景。
/dash_hls_playlist/<dash_hls_playlist>在已有dash封装上生成m3u8文件,即支持分片列表共源,同样支持多码率自适应。当dash_hls_playlist=1时,在输出mpd文件时,另外生成m3u8文件;默认dash_hls_playlist=0,仅输出mpd文件。
注:仅支持输出的目标格式为mpd
/enable_mp4_hvc1/<enable_mp4_hvc1>默认关闭,配为 1打开,此时 video track 的 stsd box里面的 tag 设置为 hvc1(默认是hev1)。注意,只适用于H.265。
/segtype/<segtype>生成的DASH文件格式,即mp4或者m4s,默认为m4s。
/segtime/<SegSeconds>用于定义每一小段音/视频流的播放时长,单位:秒,取值范围1-120的整数。
注:以下为未设置该参数,默认取值场景说明:
1、输入为非m3u8/mpd格式,默认值为10秒;
2、输入为m3u8/mpd格式,未设置转码参数,仅对索引文件进行文本处理;
3、输入为m3u8/mpd格式,设置了转码参数,自动计算切片时长
/fastStartSeg/<FastStartSeg>用于定义在m3u8切片的前M个ts片的时长为N秒,参数格式为MxNs。
例如:5x3s表示前5个ts片的切片时长为3秒。
/map/<map>设置输入流映射至输出。默认只取音视频第一路流。 举例:
(1) map=0表示将输入文件的所有流映射至输出。
(2) map=0:a,第一位0表示输入的第一个文件;第二位a表示提取类型为音频;即提取所有音频流至输出。视频流map=0:v,字幕流map=0:s。
(3) map=0:a:0,第一位0表示输入的第一个文件;第二位a表示提取类型为音频;第三位0表示音频流索引号,从0开始,即提取第一个音频流至输出。视频流map=0:v:0,字幕流map=0:s:0。
(4) map=0:a:lang=xxx,表示提取language为xxx的音频流;
视频流map=0:v:lang=xxx,字幕流map=0:s:lang=xxx;
"xxx"表示预期提取的language字段的内容,如chi,eng等。
/an/<AudioNo>是否去除音频流,0为保留,1为去除。默认值为0。
/vn/<VideoNo>是否去除视频流,0为保留,1为去除。默认值为0。
/moovToFront/<MoovToFront>将mp4文件的元信息放到头部。默认值为0,即不调整元信息的位置,1为调整。
/stripmeta/<StripMeta>是否清除文件的metadata,1为清除,0为保留。
/preset/<Preset>

HLS预设集(Preset)名称,如下表。

音频/视频预设集说明
音频

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,长宽比沿用源视频设置。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
HLS/DASH多码率自适应参数 
/envBandWidth/<EnvBandWidth>m3u8不同码流切换的带宽标准,采用符号“:”分隔多个网络带宽,个数范围[2,10],取值范围(50000,30000000],单位是b/s。例如60000:150000:500000。
注:目标格式为m3u8时使用此参数,则必填,参数个数与存在的multi参数值个数需要保持一致,建议与设置的码率值接近,带宽值采用升序方式。DASH格式配置无效。
/multiAb/<MultiAb>与音频码率参数(ab)不共存,单位:比特每秒(bit/s),采用符号“:”分隔多个音频码率,个数范围[2,10],例如64k:128k:256k。
注:若目标格式为m3u8,则码率个数与其他存在的multi参数值个数需要保持一致。
/multiVb/<MultiVb>与视频码率参数(vb)不共存,单位:比特每秒(bit/s),采用符号“:”分隔多个视频码率,个数范围[2,10],例如128k:600k:1.25m。
注:若目标格式为m3u8,则码率个数与其他存在的multi参数值个数需要保持一致。
/multiResolution/<MultiResolution>与视频分辨率参数(resolution)不共存,分辨率格式为 wxh,采用符号“:”分隔多个视频分辨率,个数范围[2,10]。
1. 正常缩放:设置宽和高,则按配置输出指定宽和高的视频。例如:320x240:640x480:1080x720。会改变视频的长宽比
2. 按宽或高自适应比率输出:仅指定宽(aaax-1)或者高(-1xaaa),则输出会根据原视频的宽高比自适应缩放。例如:320x-1:-1x480:1080x-1。
注:若目标格式为m3u8,则分辨率个数与其他存在的multi参数值个数需要保持一致。
/dash_hls_playlist/<dash_hls_playlist>在已有dash封装上生成m3u8文件,即支持分片列表共源,同样支持多码率自适应。当dash_hls_playlist=1时,在输出mpd文件时,另外生成m3u8文件;默认dash_hls_playlist=0,仅输出mpd文件。
注:仅支持输出的目标格式为mpd
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
视频截取参数
/ss/<SeekStart>指定视频截取的开始时间,单位:秒。用于视频截取,从一段视频中截取一段视频。
/t/<Duration>指定视频截取的长度,单位:秒。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
视频裁剪参数  
/vcrop/<Vcrop>

参看下表,缺省为不裁剪。

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

参看视频偏移参数表,只影响其后的裁剪偏移参数,缺省为左上角(TOP_LEFT)。

视频偏移参数表说明
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轴从下到上。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
添加字幕参数  
/subtitle/<Urlsafe_Base64_Encode(<bucket1>:<key1>),
Urlsafe_Base64_Encode(<bucket2>:<key2>),......>
字幕文件,支持:srt格式字幕(uft-8编码)、带有字幕的mkv文件(需要提取mkv视频文件中的字幕再嵌入目标视频)、embed(将原视频的字幕流嵌入目标视频),其中:
<bucket>:表示字幕文件所属空间
<key>:表示指定的字幕文件名
需要经过URL安全的Base64编码
支持多个字幕配置,且通过“,”进行分割,具体格式为:subtitle=<base64_encode>,<base64_encode>...,具体示例如:subtitle=aHR0cDovL2VuY29kZS5jaGFodW8uY29tLw,aHR0cDovL2VuY29kZS5jaGFodW8uY29tLw
/subtitleType/<subtitleType>用于显式指定字幕添加操作的类型,subtitleType=1 代表添加软字幕;subtitleType=2 代表添加硬字幕;默认subtitleType=0,即原程序自动识别的方式。
/subtitleAttr/
<Urlsafe_Base64_Encode(<lang=xx1,name=yy1>),
Urlsafe_Base64_Encode(<lang=xx2,name=yy2),...>
用于指定字幕的属性信息,当前仅用于输出为多码率m3u8且添加vtt软字幕时使用。
支持多个字幕属性的配置,且通过英文逗号“,”进行分割,具体格式为:subtitleAttr=base64_encode(lang=xx1,name=yy1),base64_encode(lang=xx2,name=yy2)……
其中,lang指定字幕的语言属性,name指定字幕的名字属性。
注:subtitleAttr值个数需要和字幕文件个数匹配,否则报错
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
添加水印参数(图片、视频水印) 
/wmImage2/
<Urlsafe_Base64_Encode (<bucket1>:<key1>,<bucket2>:<key2>...)>
图片&视频水印列表,采用“,”分隔多个水印图片路径,需要经过URL安全的Base64编码。
/wmGravity/<Gravity1><Gravity2>…图片&视频水印位置列表,若需要支持多个位置变换则以逗号分割 ,参数值定义参见“gravity”
/wmauto/<wmauto>根据视频转码分辨率变化自适应缩放图片&视频水印,为1则若转码有进行分辨率操作,则图片&视频水印进行自适应缩放,否则为原图片&视频水印大小。
例如:原视频1200x600,水印40x40,输出分辨率设置为300x200,则最终添加水印图片大小为10x10。
/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
/wmdx/<dx1>,<dx2>…用于对视频图片水印位置在偏移列表的基础上做横向微调,当值为正数时则向右偏移,反之向左。指定该参数时,wmGravity为必填,且参数个数与wmGravity保持一致。
/wmdy/<dy1>,<dy2>…用于对视频图片水印位置在偏移列表的基础上做纵向微调,当值为正数时则向下偏移,反之向上。指定该参数时,wmGravity为必填,且参数个数与wmGravity保持一致。
/wmInterval/< wmInterval >发生水印变换的时间间隔,单位是:秒。
添加水印参数(文字水印) 
/wmText/ Urlsafe_Base64_Encode(<Text1>),
Urlsafe_Base64_Encode(<Text2>)...
文字列表,若需要支持变换,不同于图片/视频水印,文字水印ship 需要每串文字先进行URL安全的Base64编码后,再用逗号连接到一块(考虑到文字包含逗号)。中文需要是UTF-8编码,否则可能显示乱码。
/wmFont/< Urlsafe_Base64_Encode(<Font1>,<Font2>...)>文字水印字体名字,若需要支持变换,字体名字先用逗号连接字体名字列表,再URL安全的Base64编码。字体名字只能包含数字、大小写字母、空格和减号“-”。
/wmFontColor/< Urlsafe_Base64_Encode(<Color1>,<Color2>...)>文字水印字体颜色,若需要支持变换,字体颜色先用逗号连接,再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/
<Urlsafe_Base64_Encode(<Color1>,<Color2>...)>
文字水印字体描边颜色,若需要支持变换,字体描边颜色先用逗号连接,再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
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
智控高清参数  
/nbhd/<nbhd>是否开启智控高清,0为不开启,1为开启。默认值为0。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
HLS标准加密参数  
/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编码。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
AI视频增强参数  
/wssr/<wssr>超分辨率倍数,目前支持放大1-3倍,即value=1,2,3 ,其他值非法。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件
AI智能标签擦除  
/AIClearADType/< AIClearADType >指定AI去除类型的功能开关。0-时长广告,1-浮层水印,2-跑马灯。
/AIClearADVideo/< AIClearADVideo>指定时长广告位置。0-片头广告,1-片中广告,2-片尾广告;默认为:0,1,2。
/AIClearADLogo/< AIClearADLogo >指定水印模糊方式。1-高斯模糊,0-拉伸模糊;默认:0-拉伸模糊。
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件

二、音视频拼接(avconcat)

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

avconcat/flv/ZmlsZUE=/ZmlsZUI=/ZmlsZUM=|saveas/YnVja2V0OmtleQ==
参数必填描述
<op>avconcat(操作类型-音视频拼接)
<format>输出的目标格式,如mp4、flv、m3u8等。
/<encodeUrl1>/<encodeUrl2>/.../<encodeUrlN>指定需要拼接的文件名,需要作URL安全的Base64编码,多个文件编码后采用"/"分隔;所有文件必须属于同一个空间;最多支持5个文件
注:可跟音频、视频转码参数结合使用
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件

三、截图(vframe)

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

vframe/jpg/offset/10|saveas/YnVja2V0OmtleQ==
参数必填描述
<op>vframe(操作类型-视频截图)
<format>输出的目标格式,支持jpg、png、gif、webp等。
/mode/<mode>缩放模式,有如下定义:
mode=1 限定缩略图的宽最少为<width>,高最少为<height>,进行等比缩放,居中裁剪。转后的缩略图通常恰好是<width>x<height>的大小(有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分)。如果只指定width参数或只指定height参数,代表宽最少为<width>或高最少为<height>的等比缩放。
mode=2 限定缩略图的宽度最多为<width>,高度最多为<height>,进行等比缩放,不裁剪。如果只指定width参数则表示限定宽度(高度自适应),只指定height参数则表示限定高度(宽度自适应)。
mode=3 限定缩略图的宽最少为<width>,高最少为<height>,进行等比缩放,不裁剪。
/offset/<Second>指定截取视频的时刻,单位:秒,支持到小数点后3位。当指定interval、offsets、vframeN截多张图或雪碧图时,该参数非必填。
特别地,
1. 当指定interval参数截多张图或雪碧图时,此参数为起始截取时刻;
2. 当指定format为gif时,与t参数共用,此参数为起始截取时刻
/offsets/<vframeList>指定截取多张视频图片,单位:秒。
格式:指定多张不同秒的图,用:间隔。例如,1:3:10:20。
注:所有截图会统一放入一个zip文件中。当saveas参数指定为images:a.zip时,zip文件名为a.zip; 截图文件命名规则为序列号的形式,如:a_00001.jpg、a_00002.jpg。
/interval/<Interval>指定连续截图的时间间隔,单位:秒。
注:所有截图会统一放入一个zip文件中。当saveas参数指定为images:a.jpg时,zip文件名为a.zip;截图文件命名规则为:a_00001.jpg,依次类推。
/vframeN/<vframeN>截图张数,范围是1,2,3,4等。
注:所有截图会统一放入一个zip文件中。当saveas参数指定为images:a.jpg时,zip文件名为a.zip;截图文件命名规则为序列号的形式,如:a_00001.jpg、a_00002.jpg。
/w/<width>缩略图宽度,单位:像素(px),取值范围为1-1920。
/h/<height>缩略图高度,单位:像素(px),取值范围为1-1080。
/autofill/<autofill>配合参数/w/和/h/一起使用,指定为1时,把图片按原始比例缩放到/w/和/h/指定的矩形框内,空隙的部分以黑色填充;指定为0或者不指定时,会强制缩放到对应分辨率,可能造成视频变形。指定autofill参数时,不能与mode参数一起共用,且/w/和/h/都需要指定。
/isZip/<isZip>除雪碧图外的多张截图支持打包,且默认会打包;若不打包需要配置为0。
/sprite/<sprite>拼图规格,如4x5,表示将连续截取的图片拼接为4行5列的一张大拼图,即雪碧图。
注:该参数需要和interval参数一起使用才有效。当saveas参数指定为images:a.jpg时,拼图文件命名规则为:a_0000x.jpg。如果只生成一个拼图时,命名为a_00001.jpg;如果有多个拼图文件,则命名为a_00001.jpg、a_00002.jpg、a_00003.jpg,依次类推。
/rotate/<degree>指定顺时针旋转的度数,可取值为90、180、270、auto,默认为不旋转。
/reverse/<reverse>是否逆序,1表示逆序,0表示不逆序,默认不逆序。
/t/<Duration>指定截取视频为GIF图片的时长,单位:秒,默认为5s。
/r/<FrameRate>视频帧率,每秒显示的帧数,单位:赫兹(Hz)。常用帧率:24,25,30等,一般用默认值。
/gif_interval/<Gif_interval>表示gif循环播放的间隔时长,单位:秒。默认间隔2s。
/speedup/<speedup>指定播放速度,取值大于0小于1表示降低播放速度,数值越小,播放速度越慢;大于1表示加快播放速度,数值越大播放速度越快。
|saveas/Encode(<bucket:filekey>)转码后文件另存为指定文件,参数中需要填入"空间:文件名"URL安全的Base64编码后的值。

四、获取专辑图片(getapic)

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

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

附录

1. 支持的字体格式

字体参数值

版权说明

Noto Sans CJK SC





Noto Sans CJK SC Regular可以在客户平台的法律内容页面加入,内容可以为:
——————————————————
XX(比如:视频水印)中Noto Sans SC、Noto Serif 字体版权方为:Google,使用授权基于OFL协议,OFL协议的原文见:https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL
Noto Sans CJK SC Black
Noto Sans CJK SC Bold
Noto Sans CJK SC DemiLight
Noto Sans CJK SC Light
Noto Sans CJK SC Medium
Noto Sans CJK SC Thin
Noto Sans Mono CJK SCNoto Sans Mono CJK SC Regular
Noto Sans Mono CJK SC Bold
Noto Serif CJK SC




Noto Serif CJK SC
Noto Serif CJK SC Black
Noto Serif CJK SC ExtraLight
Noto Serif CJK SC Light
Noto Serif CJK SC Medium
Noto Serif CJK SC SemiBold
Roboto





Roboto可以在客户平台的法律内容页面加入,内容可以为:
——————————————————
XX(比如:视频水印)中Roboto字体版权方为:Google,使用授权基于Apache协议,Apache协议的原文见:http://www.apache.org/licenses/LICENSE-2.0.txt
Roboto Condensed
Roboto Condensed Light
Roboto Black
Roboto Light
Roboto Medium
Roboto Thin
文泉驿等宽正黑WenQuanYi Zen Hei Mono可以在客户平台的法律内容页面加入,内容可以为:
——————————————————
XX(比如:视频水印)中文泉驿字体版权方为:FangQ和“文泉驿信任委员会(Board of Trustees),使用授权基于GNU General Public License协议,GNU General Public License协议的原文见:http://wenq.org/wqy2/index.cgi?GPL
文泉驿点阵正黑WenQuanYi Zen Hei Sharp
文泉驿正黑WenQuanYi Zen Hei