阿里云首页 智能媒体生产

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

横幅文字的字号。

FontColor

String

横幅文字的颜色,格式为#后跟16进制值。例如:#ffffff。

FontColorOpacity

String

横幅文字的透明度,表示文字的透明度,取值0-1。1为不透明,0为完全透明。默认为1。

FontFace

FontFace

横幅文字的字体外观。

Spacing

Integer

横幅文字字间距。单位:像素值,默认为0。

Outline

Int

横幅文字描边宽度。单位:像素值,默认为0。

OutlineColour

String

横幅文字描边颜色,格式为#后跟16进制值。例如:#ffffff。

Shadow

Int

横幅文字投下阴影的深度,单位:像素值,默认为0。

BackColour

String

横幅文字阴影颜色,格式为#后跟16进制值。例如:#ffffff。

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

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:Transition 转场

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

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

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

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

名称

类型

是否必填

描述

SubType

String

转场子类型。

取值如下:

directional(对角切换)、displacement(旋涡)、windowslice(栅格)、bowTieVertical(垂直领结)、bowTieHorizontal(水平领结)、simplezoom(放大消失)、linearblur(线性模糊)、waterdrop(水滴)、glitchmemories(故障)、polka(波点)、perlin(蔓延)、directionalwar、bounce_up(向上弹动)、bounce_down(向下弹动)、wiperight(向右擦除)、wipeleft(向左擦除)、wipedown(向下擦除)、wipeup(向上擦除)、morph、colordistance(色彩溶解)、circlecrop(圆形遮罩)、swirl(旋涡)、dreamy(轻微摇摆)、gridflip(多格翻转)、zoomincircles(圆形放大)、radial(圆形扫描)、mosaic(马赛克)、undulatingburnout(波形放大)、crosshatch(线性溶解)、crazyparametricfun(太空波纹)、kaleidoscope(万花筒)、windowblinds(百叶窗)、hexagonalize(蜂巢溶解)、glitchdisplace(故障交替)、dreamyzoom(炫境)、doomscreentransition_up(齿状上升)、doomscreentransition_down(齿状下落)、ripple(波纹)、pinwheel(风车)、angular(时钟旋转)、burn(燃烧)、circle(椭圆遮罩)、circleopen(椭圆溶解)、colorphase(色相溶解)、crosswarp(隧道扭曲)、cube(立方体)、directionalwipe(渐变擦除)、doorway(开幕)、fade(渐隐)、fadecolor(彩色渐隐)、fadegrayscale(灰色渐隐)、flyeye(回忆)、heart(爱心遮罩)、luma(对角开幕)、multiplyblend(多层混合)、pixelize(像素溶解)、polarfunction(花瓣遮罩)、randomsquares(随机方块)、rotatescalefade(旋转)、squareswire(方块替换)、squeeze(向内推入)、swap(切入)、wind(线形擦除)

Duration

Float

转场效果的时长。单位:秒,精确到小数点后4位。默认为1s。

Effect Type:VFX 特效

时间线示例: 特效 VFX Timeline 配置示例

名称

类型

是否必填

描述

SubType

String

特效子类型。

取值部分示例如下,完整取值范围及效果请参考特效效果示例

open(开幕)

close(闭幕)

h_blur(横向模糊)

v_blur(纵向模糊)

blur(模糊)

slightshake(轻微抖动)

zoominout(镜头变焦)

movie(电影感)

zoomslight(轻微放大)

zoom(逐渐放大)

withcircleopen(聚光灯打开)

withcircleclose(聚光灯关闭)

withcircleshake(聚光灯抖动)

withcircleflashlight(手电筒)

disappear(滑动消失)

shock(震惊)

bluropen(模糊开幕)

blurclose(模糊闭幕)

photograph(咔嚓)

black(曝光降低)

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的整数时,表示绝对像素。

Effect Type:Filter 滤镜

时间线示例: 滤镜 Filter Timeline 配置示例

名称

类型

是否必填

描述

SubType

String

滤镜子类型,取值部分示例如下,完整取值范围及效果请参考滤镜效果示例

M1(复古)、M2(灰调)、M3(青阶)、M4(蓝调)、M5(暗红)、M6(暗淡)、M7(灰橙)、M8(通透)、PF1(高调)、PF2(富士)、PF3(暖色)、PF4(柯达)、PF5(复古)、PF6(反转)、PF7(红外)、PF8(宝丽来)、PF9(禄来)、PFA(工业)、PFB(灰阶)、PFC(白阶)、PI1(清透)、PI2(暮晚)、PI3(秋色)、PI4(暗调)、PL1(影调)、PL2(柔和)、PL3(春芽)、PL4(明媚)、PJ1(小森林)、PJ2(童年)、PJ3(午后)、PJ4(花雾)、delta(白桃)、electric(林间)、faded(盐系)、slowlived(蓝雾)、tokoyo(东京)、urbex(雨后)、warm(温暖)、F1(济州岛)、F2(雪山)、F3(布达佩斯)、F4(蓝霜)、F5(尤加利)、F6(老街)、F7(咖啡)、PV1(质感)、PV2(天色)、PV3(清新)、PV4(雾气)、PV5(高调)、PV6(黑白)、A1(柔和)、A2(暗调)、A3(青空)、A4(蓝光)、A5(艳丽)、A6(哑光)、color(调色滤镜)

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

横幅文字的字体。具体支持的字体参见:https://help.aliyun.com/document_detail/59950.html。默认为SimSun字体。

FontSize

Int

横幅文字的字号。

FontColor

String

横幅文字的颜色,格式为#后跟16进制值。例如:#ffffff。

FontColorOpacity

String

横幅文字的透明度,表示文字的透明度,取值0-1。1为不透明,0为完全透明。默认为1。

FontFace

FontFace

横幅文字的字体外观。