素材效果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。 注:
|
SizeRequestType | String | 否 | 橫幅文字的字號到實際文字渲染大小的計算方式,默認處理方式為RealDim。
|
FixedFontSize | Int | 是 | 橫幅文字的字號。該字號不會根據素材尺寸和成片尺寸進行縮放。 注:
|
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,支持設置:
若需要在不同對齊方式下準確定位字幕位置,建議設置以下對齊方式:
|
AdaptMode | String | 否 | 橫幅文字當超出視頻寬度或超出指定TextWidth時進行自動換行或縮放:
|
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 | 否 | 橫幅文字多層效果。目前支持設置多層描邊、多層陰影、高斯模糊效果(高斯模糊僅支持在類型為陰影時使用)和字幕背景效果。 注:
| |
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 | 是 | 音頻淡入淡出子類型。取值如下:
|
Duration | Float | 否 | 淡入或淡出的時長,淡入作用在素材片段的頭部,淡出作用在素材片段的尾部。默認時長為0,即淡入淡出不生效。 |
Curve | String | 否 | 音頻淡入淡出音量曲線。默認exp。 取值如下:
|
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 | 是 | 背景顏色是否自動判斷,取值如下:
|
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 | 是 |
|
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 | 否 |
|
Effect Type: Zoom 變焦
為對應的素材 Clip 增加變焦效果。
僅支持視頻軌道 VideoTrack 中的素材 Clip 使用。
名稱 | 類型 | 是否必填 | 描述 |
StartRate | Float | 否 |
|
EndRate | Float | 否 |
|
Duration | Float | 否 |
|
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。 動態音頻標準化器確定每個輸入幀的最大可能(局部)增益因子,即不會導致削波或失真的最大增益因子。 |