API文档
更新时间：2024-01-10 14:08:01
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等，一般用默认值。 | |||||||||||||||||||||||||||||||||||||||
| /calcMD5/<calcMD5> | 否 | 配 1 打开 配 0 关闭，默认关闭，表示是否在上传时头部携带 md5（仅MP4文件） | |||||||||||||||||||||||||||||||||||||||
| /calcFrameRate/<calcFrameRate> | 否 | 配 1 打开，配 0 关闭，默认关闭,表示是否在上传时携带 frame_rate，因 flv 帧率无法低转高，配的 -r 不一定就跟转出来的视频一致，因此统一用手动计算的 frame_rate (用 getavinfo 计算),frame_rate 精确到小数点后两位 | |||||||||||||||||||||||||||||||||||||||
| /lowfps_check/<lowfps_check> | 否 | 配置为1时会进行一些调整，以支持低帧率输入视频的转码。配置为0时关闭这些调整，默认为0。具体涉及到的调整如下
（1）会根据输入视频的低帧率情况智能降低解码的线程数； （2）当源流帧率低于10时，转码输出的帧率为10. | |||||||||||||||||||||||||||||||||||||||
| /force_key_frames/<force_key_frames> | 否 | 指定插入关键帧的时间（浮点数）序列，逗号分隔，比如 force_key_frames=1.1,2.3,4.2，时间点会按升序进行排序 | |||||||||||||||||||||||||||||||||||||||
| /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 注：使用该参数时，必须指定bufsize参数 | |||||||||||||||||||||||||||||||||||||||
| /bufsize/<Bufsize> | 否 | 编码缓冲大小，和maxrate一起使用，如1000k | |||||||||||||||||||||||||||||||||||||||
| /dup_lastframe_sec/<dup_lastframe_sec> | 否 | 后面接时间代表要延长最后一帧的秒数，比如 &dup_lastframe_sec=15 表示最后一帧延长 15 秒。 | |||||||||||||||||||||||||||||||||||||||
| /GOPInterval/<GOPInterval> | 否 | 指定关键帧时间间隔范围，单位为：ms。不指定则智能按照画面情况选择，与参数g（即：每隔几帧插入关键帧）不能共用。 | |||||||||||||||||||||||||||||||||||||||
| /StrictGOPInterval/<StrictGOPInterval > | 否 | 严格指定关键帧间隔，单位ms。 当小于0 则报错退出。 大于等于0 按照配置的值生效,大于0 按指定GOP生效，等于0 则为全部I帧。 本参数与GOPInterval 或者-g 同时配置，则以本参数生效，忽略其余2个，即其余2个自动不生效。 | |||||||||||||||||||||||||||||||||||||||
| /deinterlace/<Deinterlace> | 否 | 对隔行视频做处理，参数：0、1、2、3。其中： 0-为不处理，默认不处理（无论源如何，输出都是逐行扫描，解码完后如果是隔行的，隔行的2个field会合并为一帧图像。 编码时候都是以这个图像作为输入进行编码。）； 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编码后的值，转码后文件另存为指定文件 | |||||||||||||||||||||||||||||||||||||||
| 转封装&音视频切片参数 | |||||||||||||||||||||||||||||||||||||||||
| /pat_period/<pat_period> | 否 | 用于定义PAT\PMT间隔时间，指定参数>0，单位：秒，可设定小数如0.23，5.6等 | |||||||||||||||||||||||||||||||||||||||
| /pcr_every_packet/<pcr_every_packet> | 否 | 默认关闭，配 1 打开。打开时，修改pcr_packet_period 为 1 ，表示每个包都打上 pcr | |||||||||||||||||||||||||||||||||||||||
| /rename_by_key/<RenameByM3U8> | 否 | 设置ts或二级m3u8等文件名，按照一级m3u8的文件名生成。为1 表示开启，为0表示关闭，默认为0。只对format配置M3U8有效，且为avconcat跟avthumb 2个场景。 | |||||||||||||||||||||||||||||||||||||||
| /pes_payload_size/<pes_payload_size> | 否 | 表示 pes 最小的 payload 的大小，默认不起作用。需要让单个 pes 只包含一帧时 aac 时，pes_payload_size 配 0 | |||||||||||||||||||||||||||||||||||||||
| /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）名称，如下表。
| |||||||||||||||||||||||||||||||||||||||
| |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> | 否 | 参看下表，缺省为不裁剪。
| |||||||||||||||||||||||||||||||||||||||
| /gravity/<Gravity> | 否 | 参看视频偏移参数表，只影响其后的裁剪偏移参数，缺省为左上角（TOP_LEFT）。
| |||||||||||||||||||||||||||||||||||||||
| |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视频增强参数 | |||||||||||||||||||||||||||||||||||||||||
| /nwssr/<nwssr> | 否 | 使用网宿自研新版超分。取值1-3之间代表超分的倍数，如配置nwssr=2代表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 SC | Noto 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 |
本篇文档内容对您是否有帮助？
有帮助
我要反馈