七牛云 转码_普通音视频转码（avthumb）

普通音视频转码接口方便用户对音频、视频资源进行编码和格式转换。

接口规格

注意：接口规格不含任何空格与换行符，下列内容经过格式化以便阅读。

avthumb/

/vcodec/

/avsmart/<0|1>

/smtType/

/smtEnhance/

/smtQuality/

/refine/

/maxrate/

/r/

/hr/

/vb/

/stripmeta/

/crf/

/h264Profile/

/h264Level/

/s/

/aspect/

/autoscale/

/padW/

/padH/

/padVideoX/

/padVideoY/

/gop/

/keyFramePosition/

/rotate/

/flip/

/compressLevel/

/ss/

/t/

/gifHighColor/

/deinterlace/

/wmImage/

/wmGravity/

/wmScale/

/wmScaleType/

/wmConstant/

/wmAlpha/

/wmIgnoreLoop/

/wmText/

/wmGravityText/

/wmFont/

/wmFontColor/

/wmFontSize/

/wmOffsetX/

/wmOffsetY/

/wmPos/

/wmDuration/

/wmShortest/

/mosaic/

/mosaicGravity/

/mosaicOffsetX/

/mosaicOffsetY/

/mosaicSize/

/mosaicStart/

/mosaicDuration/

/stream/

/cut/

/vn/

/sn/

/scodec/

/subtitle/

/stripmeta/

/acodec/

/ab/

/ac/

/ar/

/aq/

/audioProfile/

/volume/

/loudnorm/

/loudnormI/

/loudnormLRA/

/loudnormTP/

/an/

/speex/

/writeXing/<0|1>

/amix/

/amixOffset/

/amixStart/

/amixDuration/

/multiArep/

/multiArepOffset/

/multiArepStart/

/multiArepDuration/

封装格式

参数名称

类别

必填

说明

A/V

Y

封装格式，具体细节请参考支持转换的封装格式。

视频参数

参数名称

类别

必填

说明

/vcodec/

V

N

视频编码格式，具体细节请参考支持转换的视频编码格式。

/avsmart/

V

N

是否启用视频瘦身，设置为 1 时开启。smtType 1仅支持H.264；smtType 2支持H.264和H.265。默认使用H.264编码。注意：该参数会使 vb 失效。使用 avsmart 的计费和 avthumb 有区别。

/smtType/

V

N

开启avsmart时生效。视频瘦身模型，不同的视频内容场景适配不同的的模型，详情可咨询客服。整数，取值范围[1,2]，默认值为 1。

/smtQuality/

V

N

开启avsmart时生效。瘦身时的转码质量等级，值越大，画质越好。smtType 1时，整数，取值范围[1,5]；smtType 2时，整数，取值范围[-5,5]。

/smtEnhance/

V

N

开启avsmart时生效。视频增强开关，仅适用smtType 1。设置为 "0" 时关闭，默认开启。

/refine/

V

N

是否启用高质量转码，设置为 1 时开启。保证在视频内优化码率分配。

/maxrate/

V

N

该参数必须在使用 /refine/1 时使用，以限制输出视频流的峰值码率。当不使用 /vb/ 时，该值不可低于输入视频码率；当使用 /vb/ 时，该值不可低于由 /vb/指定的视频码率。

/r/

V

N

视频帧率，每秒显示的帧数，单位：赫兹(Hz)，常用帧率：24，25，30 等。默认等于源视频帧率，HighFrameRate=0，取值[1,30],超出范围取25帧；HighFrameRate=1时允许高帧率，取值[1,60]，超出范围取60帧。

/hr/

V

N

视频高帧率，与FrameRate配合使用，默认为HighFrameRate=0，即常规帧率；HighFrameRate=1表示保留高帧率。

/vb/

V

N

1、视频码率，单位：比特每秒(bit/s)，常用视频码率：128k，1.25m，5m等。

2、在不改变视频编码格式时，若指定码率大于原视频码率，则使用原视频码率进行转码。

3、参数末尾使用 ! ,可以以强制使用指定码率转码, 如 128k!

/crf/

V

N

1、设置 crf 值，为整数；vcodec 为 libx264 时取值为范围 [18,28]，vcodec 为 libx265 时取值范围为 [23,33]，默认取值为范围 [18,28]；

2、其值越小，输出视频质量越好，输出文件可能变大。其不可与 vb 共用

/h264Profile/

V

N

设置 h264 的 profile等级，支持 baseline、main、high。

/h264Level/

V

N

设置 h264 的 level 值，合法的值有 3.0、3.1、4.0、4.1、4.2。

/s/

V

N

0、指定目标视频分辨率，格式为宽 x 高 ，长边取值范围[20,3840]的整数，短边取值范围[20,2160]的整数。

1. w、h 都为空时，则和原视频保持一致。

2. w为空，h不为空，则按h的值对原视频等比例缩放。

3. w不为空，h为空时，则按w的值对原视频等比例缩放。

4. w、h都不为空时，则根据w、h来缩放。

/aspect/

V

N

该参数为视频在播放器中显示的宽高比，格式为:。例如：取值3:4表示视频在播放器中播放是宽:高=3:4(注：此处取值仅为体现演示效果)。

/autoscale/

V

N

0、配合分辨率参数使用，0或者不指定会强制缩放到对应分辨率，可能造成视频变形。

1、指定为1时，把视频按原始比例缩放到分辨率指定的矩形框内。

2、指定为2时，把视频按分辨率中指定的比例添加黑框后，再等比例缩放到分辨率指定到矩形框内。

/padW/

V

N

1、用于给视频添加自定义黑框，不能跟autoscale/2 共用。

2、添加黑框后的视频的宽,取值范围[20,3840]且取值大于或等于原视频宽, 和 padH 同时有效时启用 pad。

/padH/

V

N

1、用于给视频添加自定义黑框，不能跟autoscale/2 共用。

2、添加黑框后的视频高,取值范围[20,3840]且取值大于或等于原视频宽, 和 padW 同时有效时启用 pad。

/padVideoX/

V

N

1、用于给视频添加自定义黑框，不能跟autoscale/2 共用。