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的整數時，表示絕對像素。

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表示高於原始音量。音量增益不建議設定過大，否則可能會出現破音問題。

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	否	橫幅文字的字型外觀。
NeedHighlighting	Boolean	否	是否開啟ASR字幕自動高亮功能。
HighlightingStyle	Style	否	高亮字幕樣式。

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。

動態音頻標準化器確定每個輸入幀的最大可能（局部）增益因子，即不會導致削波或失真的最大增益因子。

Effect Type: FreezeFrame 靜幀

適用於視頻軌道的視頻素材。其功能是對於視頻最後一幀進行靜幀處理。

說明

僅適用於視頻軌道的視頻素材，不適用於視頻軌道的圖片素材、音頻軌道素材。

不支援和轉場Effect Type:Transition 轉場一起使用。

時間軸樣本：視頻靜幀

名稱	類型	是否必填	描述
Duration	Float	否	靜幀時間長度，預設為0，單位：秒（s）。