Effect配置说明 - 智能媒体服务

素材效果Effect的具体结构与效果类型有关，本篇将按照不同的素材效果类型分别描述。

Effect Type:Text 横幅文字

名称	类型	是否必填	描述
X	Float	否	横幅文字左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。默认为0。该坐标会按照素材尺寸和成片尺寸进行缩放。
Y	Float	否	横幅文字左上角距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。默认为0。该坐标会按照素材尺寸和成片尺寸进行缩放。
TimelineIn	Float	否	横幅文字出现在时间线的起始位置。单位：秒，精确到小数点后4位。如果TimelineIn不填，则会与对应Clip的TimelineIn保持一致。
TimelineOut	Float	否	横幅文字出现在时间线的结束位置。单位：秒，精确到小数点后4位。如果TimelineOut不填，则会与对应Clip的TimelineOut保持一致。
Content	String	是	横幅文字内容。
Font	String	否	横幅文字的字体。具体支持的字体参见字体列表。默认为SimSun字体。
FontSize	Int	是	横幅文字的字号。该字号会根据素材尺寸和成片尺寸进行缩放。默认为0，最大支持设置到5000。注： FontSize 与 FixedFontSize 仅能填写一个。如果均填写，仅有 FontSize 生效。
SizeRequestType	String	否	横幅文字的字号到实际文字渲染大小的计算方式，默认处理方式为RealDim。 Nominal：字幕渲染高度（像素值）等于字号FontSize。 RealDim：在某些字体上，字幕渲染高度（像素）可能会小于字号FontSize。
FixedFontSize	Int	是	横幅文字的字号。该字号不会根据素材尺寸和成片尺寸进行缩放。注： FontSize 与 FixedFontSize 仅能填写一个。如果均填写，仅有 FontSize 生效。
FixedX	Float	否	横幅文字左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。默认为0。该坐标不会按照素材尺寸和成片尺寸进行缩放。
FixedY	Float	否	横幅文字左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。默认为0。该坐标不会按照素材尺寸和成片尺寸进行缩放。
FontColor	String	否	横幅文字的颜色，格式为#后跟16进制值。例如：#ffffff。
FontColorOpacity	String	否	横幅文字的透明度，表示文字的透明度，取值0-1。1为不透明，0为完全透明。默认为1。
FontFace	FontFace	否	横幅文字的字体外观。
Spacing	Integer	否	横幅文字字间距。单位：像素值，默认为0。
LineSpacing	Integer	否	横幅文字行间距。单位：像素值，默认为0。
Angle	Float	否	横幅文字逆时针旋转角度。单位：度，默认为0。
BorderStyle	Int	否	设置横幅文字边框和阴影格式。取值1或3，1=边框+阴影，3=不透明底框。默认为1。
Outline	Int	否	横幅文字描边宽度。单位：像素值，默认为0。
OutlineColour	String	否	横幅文字描边颜色，格式为#后跟16进制值。例如：#ffffff。
Shadow	Int	否	横幅文字投下阴影的深度，单位：像素值，默认为0。
BackColour	String	否	横幅文字阴影颜色，格式为#后跟16进制值。例如：#ffffff。
Alignment	String	否	横幅文字定位对齐方式，默认为TopLeft，支持设置： TopLeft：视频左上角 TopCenter：视频竖直中轴线上侧 TopRight：视频右上角 CenterLeft：视频水平中轴线左侧 CenterCenter：视频中心位置 CenterRight：视频水平中轴线右侧 BottomLeft：视频左下角 BottomCenter：视频竖直中轴线下侧 BottomRight：视频右下角若需要在不同对齐方式下准确定位字幕位置，建议设置以下对齐方式： Left，左对齐，X、Y传入字幕左上角顶点相对于视频左上角的坐标 Center，居中对齐，X、Y传入字幕中轴线上边界交点相对于视频左上角的坐标 Right，右对齐，X、Y传入字幕右上角顶点相对于视频左上角的坐标
AdaptMode	String	否	横幅文字当超出视频宽度或超出指定TextWidth时进行自动换行或缩放： AutoWrap：自动换行 AutoScale：自动缩放 AutoWrapAtSpaces：只在空格位置自动换行（适用于纯英文字幕自动换行场景）
TextWidth	String	否	字幕文本框宽度，当设置AdaptMode时生效。将按照该值设置文本框宽度进行自动换行或缩放。不填写时，会按照视频宽度进行自动换行或缩放。当值大于0小于等于1时，表示相对输出视频的宽度，当值大于1时，表示绝对像素值。
FontUrl	String	否	横幅文字支持使用用户OSS的字体文件路径来生成字幕，支持ttf、otf、woff三种格式的字体文件。例如：https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf
EffectColorStyle	String	否	横幅文字花字样式类型。花字效果示例
SubtitleEffects	SubtitleEffect[]	否	横幅文字多层效果。目前支持设置多层描边、多层阴影、高斯模糊效果（高斯模糊仅支持在类型为阴影时使用）和字幕背景效果。注：如果设置SubtitleEffects时，字幕轨道中Outline、Shadow字段不会再生效。当设置多层描边/阴影/背景效果时，SubtitleEffects数组的顺序表示层级顺序，数组中第一个SubtitleEffect会渲染在最底层，数组中最后一个SubtitleEffect会渲染在最上层。
AaiMotionInEffect	String	否	当字幕类型为横幅文字时，表示横幅文字入场特效类型。字幕特效示例
AaiMotionIn	Float	否	横幅文字入场特效时长。单位：秒，精确到小数点后4位，如果AaiMotionIn不填，默认0.5s，如果文本时长小于0.5，则为总时长减去出场时长。
AaiMotionOutEffect	String	否	当字幕类型为横幅文字时，表示横幅文字出场特效类型。字幕特效示例
AaiMotionOut	Float	否	当字幕类型为横幅文字时，表示横幅文字出场特效时长，单位秒，精确到小数点后4位，如果AaiMotionOut不填，默认0.5s，如果文本时长小于0.5，则为总文本时长。
AaiMotionLoopEffect	String	否	当字幕类型为横幅文字时，表示横幅文字循环特效类型，不可与字幕入场或者出场特效同时生效。字幕特效示例
Ratio	Float	否	当字幕类型为横幅文字时，表示横幅文字循环特效播放速度，精确到小数点后4位。不填默认为1，大于1表示加速循环，小于1表示慢速循环。
TextureURL	String	否	当字幕类型为横幅文字时，表示字幕纹理效果，支持PNG、JPG、JPEG、BMP格式，目前仅支持传入OSS文件，例如https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png
BubbleStyleId	String	否	当字幕类型为横幅文字时，表示横幅文字气泡字样式类型。气泡种类及效果见：气泡字示例
BubbleWidth	Float	否	仅在使用气泡字时生效，表示气泡底图相对于输出视频的宽，大于1表示绝对像素值，小于等于表示相对值。
BubbleHeight	Float	否	仅在使用气泡字时生效，表示气泡底图相对于输出视频的高，大于1表示绝对像素值，小于等于表示相对值。

Effect Type:DeWatermark 遮标

名称	类型	是否必填	描述
X	Float	否	模糊区域左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。默认为0。
Y	Float	否	模糊区域左上角距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。默认为0。
Width	Float	是	模糊区域在输出视频中的宽度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。
Height	Float	是	模糊区域在输出视频中的高度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。
TimelineIn	Float	否	模糊区域出现在时间线的起始位置。单位：秒，精确到小数点后4位。如果TimelineIn不填，则会与对应Clip的TimelineIn保持一致。
TimelineOut	Float	否	模糊区域出现在时间线的结束位置。单位：秒，精确到小数点后4位。如果TimelineOut不填，则会与对应Clip的TimelineOut保持一致。

Effect Type:Crop 裁剪

名称	类型	是否必填	描述
X	Float	否	裁剪后保留的区域左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。默认为0。
Y	Float	否	裁剪后保留的区域左上角距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。默认为0。
Width	Float	是	裁剪后保留的区域在输出视频中的宽度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。
Height	Float	是	裁剪后保留的区域在输出视频中的高度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。

Effect Type:Scale 缩放

注：当未指定Scale效果，且素材画面宽高与输出视频画面不一致时，自动将素材画面缩放到宽或高与输出画面一致，另2边自动贴上下黑边或左右黑边，素材画面居中

时间线示例：视频画中画

名称	类型	是否必填	描述
Width	Float	是	缩放后保留的区域在输出视频中的宽度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=1的整数时，表示绝对像素。
Height	Float	是	缩放后保留的区域在输出视频中的高度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=1的整数时，表示绝对像素。

Effect Type:Pad 贴边

注：当未指定Pad效果，且素材画面比例与输出视频画面比例不符时，自动将素材画面缩放到宽或高与输出画面一致，另2边自动贴上下黑边或左右黑边，素材画面居中

时间线示例：视频横转竖-补充上下模糊区域

名称	类型	是否必填	描述
Left	Float	否	素材画面左边输出视频左边的距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=1的整数时，表示绝对像素。
Right	Float	否	素材画面右边输出视频右边的距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=1的整数时，表示绝对像素。
Top	Float	否	素材画面上边输出视频上边的距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=1的整数时，表示绝对像素。
Bottom	Float	否	素材画面下边输出视频下边的距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=1的整数时，表示绝对像素。
Color	String	否	贴边颜色，格式为#后跟16进制值。例如：#000000。默认值为黑色。

Effect Type:Background 背景设置

背景设置包括背景模糊、背景颜色，当素材尺寸和成片尺寸不一致时，此特效可对空白区域进行设置。

背景设置可与裁剪、缩放、特效、转场等Effect叠加使用。

时间线示例：视频横转竖-补充上下模糊区域

名称	类型	是否必填	描述
SubType	String	是	子类型。取值如下： Blur：背景模糊 Color：背景颜色
Radius	Float	否	模糊半径，当SubType=Blur时，此参数生效，取值范围[0.01, 1]
Color	String	否	当SubType=Color时，此参数生效，表示颜色值，16进制RGB颜色表示，示例：#FFFFFF

Effect Type:Transition 转场

重要

本转场是通过前后两个素材在同一时间内图层重叠实现效果，因此会导致成片时长缩短。如需避免时长缩短，请使用下文介绍的 DLTransition 补帧转场。

转场效果出现在两个素材之间，只需要在对前一个素材设置转场过渡的时长，转场效果会作用于前一个素材的尾部与后一个素材的头部，在转场中，视频画面会进行叠加，因此其时长将比没有加转场效果少，减少的部分即为转场过渡的时长。

如：视频轨有2个素材，Clip1和Clip2，Clip1时长为10s，Clip2为8s，在Clip1与Clip2之间添加4s的转场效果，则视频轨的总时长由18s缩短到14s。

转场属性配置如下，具体转场效果参考文档：转场效果示例

时间线示例：转场 Transition Timeline 配置示例

名称	类型	是否必填	描述
SubType	String	是	转场子类型。支持传入多个转场子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有转场子类型中随机选取一个，示例值：directional，完整取值范围及效果请参考：转场效果示例。
Duration	Float	否	转场效果的时长。单位：秒，精确到小数点后4位。默认为1s。

Effect Type:DLTransition 补帧转场

相比前述的普通转场 Transition，补帧转场 DLTransition（Duration Lock Transition），通过在转场过度时填充静帧画面，不会导致成片时长缩短。

其内部参数使用方式，与前述 Transition 一致。

名称	类型	是否必填	描述
SubType	String	是	转场子类型。支持传入多个转场子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有转场子类型中随机选取一个，示例值：directional，完整取值范围及效果请参考：转场效果示例。
Duration	Float	否	转场效果的时长。单位：秒，精确到小数点后4位。默认为1s。

Effect Type:VFX 特效

时间线示例：VFX特效

名称	类型	是否必填	描述
SubType	String	是	特效子类型。支持传入多个特效子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有特效子类型中随机选取一个，示例值：colorfulradial，完整取值范围及效果请参考特效效果示例
X	Float	否	该字段仅支持SubType为mosaic_rect/blur的情况。特效区域左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。
Y	Float	否	该字段仅支持SubType为mosaic_rect/blur的情况。特效区域距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。
Width	Float	否	该字段仅支持SubType为mosaic_rect/blur的情况。特效区域在输出视频中的宽度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。
Height	Float	否	该字段仅支持SubType为mosaic_rect/blur的情况。特效区域在输出视频中的高度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。
ExtParams	String	否	特效相关拓展参数。该字段仅在SubType=mask_circle、mask_rec、mask_linear、mask_minor，即遮罩场景下生效，遮罩ExtParams相关配置参数见下。

遮罩示例以及成片效果：遮罩效果

重要

以下遮罩参数，若参数类型为浮点数，则需要严格设置为浮点数形式，如：0.5、2.0。

圆形遮罩特效参数说明及示例

SubType=mask_circle

ExtParams参数说明

参数	类型	取值范围	默认值	说明
x	float	[0.0, 素材宽]	0.5	遮罩圆心在素材内相比素材左上角的X坐标。[0.0, 1.0]时表示相对素材宽的坐标，大于1.0时，表示绝对像素值。
y	float	[0.0, 素材高]	0.5	遮罩圆心在素材内相比素材左上角的Y坐标。[0.0, 1.0]时表示相对素材高的坐标，大于1.0时，表示绝对像素值。
width	float	[0.0, 素材宽]	0.8	遮罩椭圆的宽度，相比素材宽度。[0.0, 1.0]时表示相对素材宽的宽度，大于1.0时，表示绝对像素值。
height	float	[0.0, 素材高]	0.8	遮罩椭圆的高度，相比素材宽度。[0.0, 1.0]时表示相对素材高的高度，大于1.0时，表示绝对像素值。
antialias	float	[0.0, 1.0]	0.1	遮罩椭圆的抗锯齿参数。值越大，边缘羽化程度越高。
angle	float	[-9999.0, 9999.0]	0.0	旋转角度。

矩形遮罩特效参数说明及示例

SubType=mask_rec

ExtParams参数说明

参数	类型	取值范围	默认值	说明
x	float	[0.0, 素材宽]	0.5	遮罩矩形中心在视频素材内相比素材左上角的X坐标。[0.0, 1.0]时表示相对素材宽的坐标，大于1.0时，表示绝对像素值。
y	float	[0.0, 素材高]	0.5	遮罩矩形中心在视频素材内相比素材左上角的Y坐标。[0.0, 1.0]时表示相对素材高的坐标，大于1.0时，表示绝对像素值。
width	float	[0.0, 素材宽]	0.8	遮罩矩形的宽度。[0.0, 1.0]时表示相对素材宽的宽度，大于1.0时，表示绝对像素值。
height	float	[0.0, 素材高]	0.8	遮罩矩形的高度。[0.0, 1.0]时表示相对素材高的高度，大于1.0时，表示绝对像素值。
antialias	float	[0.0, 1.0]	0.1	遮罩矩形的抗锯齿参数，值越大，边缘羽化程度越高。
radius	float	[0.0, 素材宽或高的较大值]	0.1	遮罩矩形圆角半径。[0.0, 1.0]时表示相对素材宽或高的较大值的半径大小，大于1.0时，表示绝对像素值。
angle	float	[-9999.0, 9999.0]	0.0	旋转角度。

线性遮罩特效参数说明及示例

SubType=mask_linear

ExtParams参数说明

参数	类型	取值范围	默认值	说明
x	float	[0.0, 素材宽]	0.5	线形遮罩中心基准点在素材内相比素材左上角的X坐标。[0.0, 1.0]时表示相对素材宽的坐标，大于1.0时，表示绝对像素值。
y	float	[0.0, 素材高]	0.5	线性遮罩中心基准点在视频素材内相比视频左上角的Y坐标。[0.0, 1.0]时表示相对素材宽的坐标，大于1.0时，表示绝对像素值。
antialias	float	[0.0, 1.0]	0.1	线性遮罩的抗锯齿参数，值越大，边缘羽化程度越高。
angle	float	[-9999.0, 9999.0]	0.0	旋转角度。

镜面遮罩特效参数说明及示例

SubType=mask_minor

ExtParams参数说明

参数	类型	取值范围	默认值	说明
x	float	[0.0, 素材宽]	0.5	镜面遮罩中心基准点在素材内相比素材左上角的X坐标。[0.0, 1.0]时表示相对素材宽的坐标，大于1.0时，表示绝对像素值。
y	float	[0.0, 素材高]	0.5	镜面遮罩中心基准点在素材内相比素材左上角的Y坐标。[0.0, 1.0]时表示相对素材高的坐标，大于1.0时，表示绝对像素值。
antialias	float	[0.0, 1.0]	0.1	镜面遮罩的抗锯齿参数，值越大，边缘羽化程度越高。
angle	float	[-9999.0, 9999.0]	0.0	旋转角度。

Effect Type:Filter 滤镜

时间线示例： Filter滤镜

名称	类型	是否必填	描述
SubType	String	是	滤镜子类型，支持传入多个滤镜子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有滤镜子类型中随机选取一个，示例值：M1，完整取值范围及效果请参考：滤镜效果示例
TimelineIn	Float	否	滤镜出现在时间线的起始位置。单位：秒，精确到小数点后4位。如果TimelineIn不填，则会与对应Clip的TimelineIn保持一致。
TimelineOut	Float	否	滤镜出现在时间线的结束位置。单位：秒，精确到小数点后4位。如果TimelineOut不填，则会与对应Clip的TimelineOut保持一致。
ExtParams	String	否	滤镜相关拓展参数。该字段仅在SubType=color，即颜色滤镜时生效，调色滤镜ExtParams相关配置参数见下。

调色滤镜ExtParams参数说明及示例

时间线示例：使用颜色滤镜

ExtParams参数说明

参数	类型	取值范围	说明	默认值
brightness	int	[-255,255]	亮度	0
contrast	int	[-100,100]	对比度	0
saturation	int	[-100,100]	饱和度	0
kelvin_temperature	int	[1000,40000]	温度，配合 temperature_ratio生效	6000
temperature_ratio	int	[0,100]	温度比例	0
tint	int	[-100,100]	色调	0
dark_corner_ratio	int	[0,100]	暗角比例	0

Effect Type:Volume 调音

时间线示例：视频整体静音、视频调节音量＋音频调节音量示例

名称	类型	是否必填	描述
Gain	Float	否	音量增益。取值范围：0-10。值越小音量越低，0表示静音；1表示原始音量；小于1表示低于原始音量；大于1表示高于原始音量。默认为1。音量增益不建议设置过大，否则可能会出现破音问题。

Effect Type:AFade 音频淡入淡出

时间线示例：纯音频配置淡入淡出+视频中的音频配置淡入淡出

名称	类型	是否必填	描述
SubType	String	是	音频淡入淡出子类型。取值如下： In（淡入） Out（淡出）
Duration	Float	否	淡入或淡出的时长，淡入作用在素材片段的头部，淡出作用在素材片段的尾部。默认时长为0，即淡入淡出不生效。
Curve	String	否	音频淡入淡出音量曲线。默认exp。取值如下： exp （音量指数型渐强/渐弱） tri （音量线性渐强/渐弱）

Effect Type:AI_ASR 语音转文字

根据音频，生成字幕。可放置于视频轨或音频轨的Effects 中，参数同Effect Type:Text 横幅文字。默认效果字幕居中置于视频底部。目前仅支持北京、上海、杭州区域调用。

名称	类型	是否必填	描述
X	Float	否	横幅文字左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。
Y	Float	否	横幅文字左上角距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。
Font	String	否	横幅文字的字体。具体支持的字体参见：字体列表。默认为SimSun字体。
FontSize	Int	是	横幅文字的字号。
FontColor	String	否	横幅文字的颜色，格式为#后跟16进制值。例如：#ffffff。
FontColorOpacity	String	否	横幅文字的透明度，表示文字的透明度，取值0-1。1为不透明，0为完全透明。默认为1。
FontFace	FontFace	否	横幅文字的字体外观。

Effect Type:Rotate 素材旋转

将素材旋转一定角度，目前仅支持旋转90°、180°、270°。可放置于视频轨或图片轨素材的Effects 中。

时间线示例：素材旋转

名称	类型	是否必填	描述
Degree	Integer	是	素材顺时针旋转的角度。目前仅支持旋转90°、180°、270°。

Effect Type:AI_Matting 绿幕抠图

把被摄物体从绿幕或者蓝幕的背景色中抠出，叠加到其他背景视频或者图片上。目前仅支持北京、上海、杭州区域调用。

名称	类型	是否必填	描述
Color	String	是	背景颜色。目前仅支持green（绿幕抠图）、blue（蓝幕抠图）。
Auto	Integer	是	背景颜色是否自动判断，取值如下： 0（根据阈值进行判别） 1（自动判别）
Thres	Float	否	背景颜色判别阈值，值越大，判别越宽松，取值范围为[0, 10]。

Effect Type:AI_RealMatting 实景抠图

把视频中的人像部分从实景中抠出，叠加到其他背景视频或者图片上。目前仅支持北京、上海、杭州区域调用。

名称	类型	是否必填	描述
Thres	Float	否	背景颜色判别阈值，值越大，判别越宽松，取值范围为[0, 10]，默认为2。

Effect Type:AI_Delogo 智能去台标

智能识别并去除视频中的台标。目前仅支持北京、上海区域调用。

Effect Type:Clip 随机截取

截取功能，目前只支持随机截取，从原始素材中随机截取一段时间片段，拼入到时间线中。

名称	类型	是否必填	描述
SubType	String	是	截取类型。目前仅支持随机截取：RandomClip。
ClipDuration	Float	是	截取片段的时长

Effect Type:Flip 翻转

视频轨道中的视频或者图片，支持在水平方向或者垂直方向进行画面翻转。

时间线示例：水平翻转、垂直翻转

名称	类型	是否必填	描述
Direction	String	是	horizontal：水平方向翻转 vertical：竖直方向翻转

Effect Type:KenBurns 镜头推拉

对于视频轨道中的视频或者图片，施加镜头推拉的特效效果。

使用限制：

本特效适用于图片、视频，可以和VFX、滤镜、转场一起使用。
本效果支持设置输出画面的宽高（见下方WindowW/WindowH参数），因此不支持与Crop/Scale/Pad/Background 特效一起使用。

名称		类型	对否必填	说明	示例
Duration		Float	否	特效持续时间，默认等于clip时长，最大值10，单位（s）	5
WindowW		Float	否	最终输出片段的画面宽度，默认等于输出视频的宽度，单位：像素（px）。 0 < WindowW <= 1 表示相对值，> 1 表示绝对值。	1
WindowH		Float	否	最终输出片段的画面高度，默认等于输出视频的高度，单位：像素（px）。 0 < WindowH <= 1 表示相对值 > 1 表示绝对值。	1
Start		String	否	特效开始时，画框左上角在原始素材中的位置（横坐标、纵坐标、宽度、高度）, 以英文逗号隔开，皆非必填。 "StartX,StartY,StartW,StartH" 限制： 0 < StartX + StartW <=1 0 < StartY + StartH <=1	"0,0,0.9,0.9"
	StartX	Float	否	特效开始时，画框左上角在原始素材中的横坐标，单位：像素（px）。 0 <= StartX < 1 表示相对值 >= 1 表示绝对值。	0
	StartY	Float	否	特效开始时，画框左上角在原始素材中的纵坐标，单位：像素（px）。 0 <= StartY < 1 表示相对值 >= 1 表示绝对值。	0
	StartW	Float	否	特效开始时，画框在原始素材中的宽度，单位：像素（px）。 0 < StartW <= 1 表示相对值 > 1 表示绝对值。	0.9
	StartH	Float	否	特效开始时，画框在原始素材中的高度，单位：像素（px）。 0 < StartH <= 1 表示相对值 > 1 表示绝对值。	0.9
End		String	否	特效结束时，画框左上角在原始素材中的位置（横坐标、纵坐标、宽度、高度）, 以英文逗号隔开，皆非必填。 "EndX,EndY,EndW,EndH" 限制： 0 < EndX + EndW <=1 0 < EndY + EndH <=1	"0,0,1,1"
	EndX	Float	否	特效结束时，画框左上角在原始素材中的横坐标，单位：像素（px）。 0 <= StartX < 1 表示相对值 >= 1 表示绝对值。	0
	EndY	Float	否	特效结束时，画框左上角在原始素材中的纵坐标，单位：像素（px）。 0 <= StartY < 1 表示相对值 >= 1 表示绝对值。	0
	EndW	Float	否	特效结束时，画框在原始素材中的宽度，单位：像素（px）。 0 < StartW <= 1 表示相对值 > 1 表示绝对值。	1
	EndH	Float	否	特效结束时，画框在原始素材中的高度，单位：像素（px）。 0 < StartH <= 1 表示相对值 > 1 表示绝对值。	1

Effect Type:ADenoise 音频降噪

视频轨道中包含音频的视频或者音频轨道中的音频，支持进行降噪处理。

名称	类型	是否必填	描述
Mode	Integer	否	0：不处理（默认） 1：幅度较小的降噪 2：保护音乐去除平稳噪声，适合音乐类内容 3：强力去除平稳噪声，适合演讲类无音乐内容 4：语音提取，去除平稳和非平稳噪声，适合非音乐内容

Effect Type: Zoom 变焦

为对应的素材 Clip 增加变焦效果。

重要

仅支持视频轨道 VideoTrack 中的素材 Clip 使用。

名称	类型	是否必填	描述
StartRate	Float	否	起始缩放比率默认值：1.0 取值范围：[1.0, 5.0]
EndRate	Float	否	结束缩放比率默认值：StartRate + 0.3 取值范围：[StartRate, 5.0]
Duration	Float	否	效果持续时长默认值：当前 Clip 渲染时长取值范围：[0, 当前 Clip 渲染时长]

Effect Type: Harmonization 背景融合

为对应的素材 Clip 增加背景融合效果，主要适用于数字人视频 Clip，当为数字人视频 Clip 添加此 Effect 后，会自适应背景图片的光线、明暗、冷暖等效果，减少数字人视频 Clip 与背景图片的结合时的“突兀”感。

重要

仅支持视频轨道 VideoTrack 中的素材 Clip 使用；
在 1 次剪辑请求中，仅允许添加 1 个背景融合效果。

本 Effect 没有其它入参。

Effect Type：ALoudNorm 音量归一

ALoudNorm只适用于单个音视频素材。如果您有多个音视频素材，且希望它们的响度相同，您可能需要在每个素材上分别配置ALoudNorm。

说明

仅适用于音视频clip，如果ALoudNorm和ADenosie或Volume一起使用时，应用顺序为：ADenoise > Volume > ALoudNorm。

时间线示例：音量归一

名称	类型	是否必填	描述
Loudness	Float	否	目标响度，决定了音量的大小，符合ebur128度量；取值范围[-70.0,-5.0]，默认值为-24.0；
TruePeak	Float	否	真峰值电平，限制音频信号的最高峰值电平；取值范围[-9.0,+0.0]，默认值-2.0；

Effect Type: AEqualize 音量均衡

适用于特效轨，为全局特效。其功能是对于全局音频进行统一的音量均衡处理。

说明

仅适用于全局，不支持单clip。

时间线示例：音量均衡

名称

类型

是否必填

描述

Peak

Float

否

音频目标峰值。默认值为0.95，不建议超过该值。

取值 (0,1) 两边开区间。

Gain

Float

否

设置最大增益系数。范围从1.0到100.0。默认值为10.0。

动态音频标准化器确定每个输入帧的最大可能（局部）增益因子，即不会导致削波或失真的最大增益因子。