名稱

類型

是否必填

描述

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

是

橫幅文字的字號。該字號會根據素材尺寸和成片尺寸進行縮放。

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。

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：視頻右下角

AdaptMode

String

否

橫幅文字當超出視頻寬度或超出指定TextWidth時進行自動換行或縮放。取值：

• AutoWrap：自動換行

• AutoScale：自動縮放

• AutoWrapAtSpaces：只在空格位置自動換行（適用于純英文字幕自動換行場景）

TextWidth

String

否

字幕文本框寬度，當設置AdaptMode時生效。將按照該值設置文本框寬度進行自動換行或縮放。不填寫時，會按照視頻寬度進行自動換行或縮放。單位：像素值。

FontUrl

String

否

橫幅文字支持使用用戶OSS的字體文件路徑來生成字幕，支持ttf、otf、woff三種格式的字體文件。

示例：https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

EffectColorStyle

String

否

橫幅文字花字樣式類型。

花字種類及效果請參見花字效果示例。

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表示慢速循環。

名稱

類型

是否必填

描述

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保持一致。

名稱

類型

是否必填

描述

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

名稱

類型

是否必填

描述

Width

Float

是

縮放后保留的區域在輸出視頻中的寬度。

支持百分比和像素兩種形式。當取值為[0, 0.9999]時，表示相對輸出視頻寬的占比。當取值為≥1的整數時，表示絕對像素。

Height

Float

是

縮放后保留的區域在輸出視頻中的高度。

支持百分比和像素兩種形式。當取值為[0, 0.9999]時，表示相對輸出視頻高的占比。當取值為≥1的整數時，表示絕對像素。

名稱

類型

是否必填

描述

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。默認值為黑色。

名稱

類型

是否必填

描述

SubType

String

是

子類型。取值：

Blur：背景模糊

Color：背景顏色

Radius

Float

否

模糊半徑，當SubType=Blur時，此參數生效，取值范圍[0.01, 1]。

Color

String

否

當SubType=Color時，此參數生效，表示顏色值，16進制RGB顏色表示。

示例：#FFFFFF

名稱

類型

是否必填

描述

SubType

String

是

轉場子類型。支持傳入多個轉場子類型，用英文逗號隔開，將從中隨機選取一個，或者傳入random，將從所有轉場子類型中隨機選取一個，完整的取值范圍及效果請參見轉場效果示例。

示例：directional

Duration

Float

否

轉場效果的時長。單位：秒，精確到小數點后4位。默認為1s。

名稱

類型

是否必填

描述

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

名稱

類型

是否必填

描述

SubType

String

是

濾鏡子類型，支持傳入多個濾鏡子類型，用英文逗號隔開，將從中隨機選取一個，或者傳入random，將從所有濾鏡子類型中隨機選取一個，完整取值范圍及效果請參見濾鏡效果示例。

示例值：M1

TimelineIn

Float

否

濾鏡出現在時間線的起始位置。單位：秒，精確到小數點后4位。如果TimelineIn不填，則會與對應Clip的TimelineIn保持一致。

TimelineOut

Float

否

濾鏡出現在時間線的結束位置。單位：秒，精確到小數點后4位。如果TimelineOut不填，則會與對應Clip的TimelineOut保持一致。

ExtParams

String

否

濾鏡相關拓展參數。該字段僅在SubType=color，即顏色濾鏡時生效，調色濾鏡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

名稱

類型

是否必填

描述

Gain

Float

否

音量增益。取值范圍：0-10。值越小音量越低，0表示靜音；1表示原始音量；小于1表示低于原始音量；大于1表示高于原始音量。默認為1。

名稱

類型

是否必填

描述

SubType

String

是

音頻淡入淡出子類型。取值如下：

• In（淡入）

• Out（淡出）

Duration

Float

否

淡入或淡出的時長，淡入作用在素材片段的頭部，淡出作用在素材片段的尾部。默認時長為0，即淡入淡出不生效。

Curve

String

否

音頻淡入淡出音量曲線。默認為exp。

取值：

• exp：音量指數型漸強/漸弱

• tri：音量線性漸強/漸弱

名稱

類型

是否必填

描述

Degree

Integer

是

素材順時針旋轉的角度。目前僅支持旋轉90°、180°、270°。

名稱

類型

是否必填

描述

SubType

String

是

截取類型。目前僅支持隨機截取：RandomClip。

ClipDuration

Float

是

截取片段的時長。

名稱

類型

是否必填

描述

Direction

String

是

• horizontal：水平方向翻轉

• vertical：豎直方向翻轉

名稱

類型

對否必填

說明

示例

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

名稱

類型

是否必填

描述

StartRate

Float

否

• 起始縮放比率

• 默認值：1.0

• 取值范圍：[1.0, 5.0]

EndRate

Float

否

• 結束縮放比率

• 默認值：StartRate + 0.3

• 取值范圍：[StartRate, 5.0]

Duration

Float

否

• 效果持續時長

• 默認值：當前 Clip 渲染時長

• 取值范圍：[0, 當前 Clip 渲染時長]