BCD 中文站

素材效果Effect的具体结构与效果类型有关，本篇将按照不同的素材效果类型分别描述。转场效果出现在两个素材之间，只需要在对前一个素材设置转场过渡的时长，转场效果会作用于前一个素材的尾部与后一个素材的头部，在转场中，视频画面会进行叠加，因此其时长将比没有加转场效果少，减少的部分即为转场过渡的时长。如：视频轨有2个素材，Clip1和Clip2，Clip1时长为10s，Clip2为8s，在Clip1与Clip2之间添加4s的转场效果，则视频轨的总时长由18s缩短到14s。转场属性配置如下，具体转场效果参考文档：转场效果示例时间线示例：转场 Transition Timeline 配置示例名称类型是否必填描述SubTypeString是转场子类型。支持传入多个转场子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有转场子类型中随机选取一个，示例值：directional，完整取值范围及效果请参考：转场效果示例。DurationFloat否转场效果的时长。单位：秒，精确到小数点后4位。默认为1s。Effect Type:DLTransition 补帧转场相比前述的普通转场 Transition，补帧转场 DLTransition（Duration Lock Transition），通过在转场过度时填充静帧画面，不会导致成片时长缩短。其内部参数使用方式，与前述 Transition 一致。名称类型是否必填描述SubTypeString是转场子类型。支持传入多个转场子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有转场子类型中随机选取一个，示例值：directional，完整取值范围及效果请参考：转场效果示例。DurationFloat否转场效果的时长。单位：秒，精确到小数点后4位。默认为1s。Effect Type:VFX 特效时间线示例：特效 VFX Timeline 配置示例名称类型是否必填描述SubTypeString是特效子类型。支持传入多个特效子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有特效子类型中随机选取一个，示例值：colorfulradial，完整取值范围及效果请参考特效效果示例XFloat否该字段仅支持SubType为mosaic_rect/blur的情况。特效区域左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。YFloat否该字段仅支持SubType为mosaic_rect/blur的情况。特效区域距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。WidthFloat否该字段仅支持SubType为mosaic_rect/blur的情况。特效区域在输出视频中的宽度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。HeightFloat否该字段仅支持SubType为mosaic_rect/blur的情况。特效区域在输出视频中的高度。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。Effect Type:Filter 滤镜时间线示例： 滤镜 Filter Timeline 配置示例名称类型是否必填描述SubTypeString是滤镜子类型，支持传入多个滤镜子类型，用英文逗号隔开，将从中随机选取一个，或者传入random，将从所有滤镜子类型中随机选取一个，示例值：M1，完整取值范围及效果请参考：滤镜效果示例TimelineInFloat否滤镜出现在时间线的起始位置。单位：秒，精确到小数点后4位。如果TimelineIn不填，则会与对应Clip的TimelineIn保持一致。TimelineOutFloat否滤镜出现在时间线的结束位置。单位：秒，精确到小数点后4位。如果TimelineOut不填，则会与对应Clip的TimelineOut保持一致。ExtParamsString否滤镜相关拓展参数。该字段仅在SubType=color，即颜色滤镜时生效，调色滤镜ExtParams相关配置参数见下。调色滤镜ExtParams参数说明及示例时间线示例：使用颜色滤镜ExtParams参数说明参数类型取值范围说明默认值brightnessint[-255,255]亮度0contrastint[-100,100]对比度0saturationint[-100,100]饱和度0kelvin_temperatureint[1000,40000]温度，配合temperature_ratio生效6000temperature_ratioint[0,100]温度比例0tintint[-100,100]色调0dark_corner_ratioint[0,100]暗角比例0Effect Type:Volume 调音时间线示例：整体静音示例、视频调节音量＋音频调节音量示例名称类型是否必填描述GainFloat否音量增益。取值范围：0-10。值越小音量越低，0表示静音；1表示原始音量；小于1表示低于原始音量；大于1表示高于原始音量。默认为1。Effect Type:AFade 音频淡入淡出时间线示例：视频的音频配置淡入淡出示例、音频配置淡入淡出示例名称类型是否必填描述SubTypeString是音频淡入淡出子类型。取值如下：In（淡入）Out（淡出）DurationFloat否淡入或淡出的时长，淡入作用在素材片段的头部，淡出作用在素材片段的尾部。默认时长为0，即淡入淡出不生效。CurveString否音频淡入淡出音量曲线。默认exp。取值如下：exp （音量指数型渐强/渐弱）tri （音量线性渐强/渐弱）Effect Type:AI_ASR 语音转文字根据音频，生成字幕。可放置于视频轨或音频轨的Effects 中，参数同Effect Type:Text 横幅文字。默认效果字幕居中置于视频底部。目前仅支持北京、上海、杭州区域调用。时间线示例：对视频进行语音识别，并将字幕合成到视频中名称类型是否必填描述XFloat否横幅文字左上角距离输出视频左上角的横向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频宽的占比。当取值为>=2的整数时，表示绝对像素。YFloat否横幅文字左上角距离输出视频左上角的纵向距离。注：支持百分比和像素两种形式。当取值为[0～0.9999]时，表示相对输出视频高的占比。当取值为>=2的整数时，表示绝对像素。FontString否横幅文字的字体。具体支持的字体参见：https://help.aliyun.com/document_detail/59950.html。默认为SimSun字体。FontSizeInt是横幅文字的字号。FontColorString否横幅文字的颜色，格式为#后跟16进制值。例如：#ffffff。FontColorOpacityString否横幅文字的透明度，表示文字的透明度，取值0-1。1为不透明，0为完全透明。默认为1。FontFaceFontFace否横幅文字的字体外观。Effect Type:Rotate 素材旋转将素材旋转一定角度，目前仅支持旋转90°、180°、270°。可放置于视频轨或图片轨素材的Effects 中。时间线示例：素材旋转名称类型是否必填描述DegreeInteger是素材顺时针旋转的角度。目前仅支持旋转90°、180°、270°。Effect Type:AI_Matting 绿幕抠图把被摄物体从绿幕或者蓝幕的背景色中抠出，叠加到其他背景视频或者图片上。目前仅支持北京、上海、杭州区域调用。时间线示例：绿幕抠图名称类型是否必填描述ColorString是背景颜色。目前仅支持green（绿幕抠图）、blue（蓝幕抠图）。AutoInteger是背景颜色是否自动判断，取值如下：0（根据阈值进行判别）1（自动判别）ThresFloat否背景颜色判别阈值，值越大，判别越宽松，取值范围为[0, 10]。Effect Type:AI_RealMatting 实景抠图把视频中的人像部分从实景中抠出，叠加到其他背景视频或者图片上。目前仅支持北京、上海、杭州区域调用。时间线示例：实景抠图名称类型是否必填描述ThresFloat否背景颜色判别阈值，值越大，判别越宽松，取值范围为[0, 10]，默认为2。Effect Type:AI_Delogo 智能去台标智能识别并去除视频中的台标。目前仅支持北京、上海区域调用。时间线示例：去台标Effect Type:Clip 随机截取截取功能，目前只支持随机截取，从原始素材中随机截取一段时间片段，拼入到时间线中。时间线示例：随机效果名称类型是否必填描述SubTypeString是截取类型。目前仅支持随机截取：RandomClip。ClipDurationFloat是截取片段的时长Effect Type:Flip 翻转视频轨道中的视频或者图片，支持在水平方向或者垂直方向进行画面翻转。时间线示例：视频翻转示例名称类型是否必填描述DirectionString是horizontal：水平方向翻转vertical：竖直方向翻转Effect Type:KenBurns 镜头推拉对于视频轨道中的视频或者图片，施加镜头推拉的特效效果。使用限制：本特效适用于图片、视频，可以和VFX、滤镜、转场一起使用。本效果支持设置输出画面的宽高（见下方WindowW/WindowH参数），因此不支持与Crop/Scale/Pad/Background 特效一起使用。时间线示例：镜头推拉功能名称类型对否必填说明示例DurationFloat否特效持续时间，默认等于clip时长，最大值10，单位 （s）5WindowWFloat否最终输出片段的画面宽度，默认等于输出视频的宽度，单位：像素（px）。0 < WindowW <= 1 表示相对值，> 1 表示绝对值。1WindowHFloat否最终输出片段的画面高度，默认等于输出视频的高度，单位：像素（px）。0 < WindowH <= 1 表示相对值> 1 表示绝对值。1StartString否特效开始时，画框左上角在原始素材中的位置（横坐标、纵坐标、宽度、高度）, 以英文逗号隔开，皆非必填。"StartX,StartY,StartW,StartH"限制：0 < StartX + StartW <=10 < StartY + StartH <=1"0,0,0.9,0.9"StartXFloat否特效开始时，画框左上角在原始素材中的横坐标，单位：像素（px）。0 <= StartX < 1 表示相对值>= 1 表示绝对值。0StartYFloat否特效开始时，画框左上角在原始素材中的纵坐标，单位：像素（px）。0 <= StartY < 1 表示相对值>= 1 表示绝对值。0StartWFloat否特效开始时，画框在原始素材中的宽度，单位：像素（px）。0 < StartW <= 1 表示相对值> 1 表示绝对值。0.9StartHFloat否特效开始时，画框在原始素材中的高度，单位：像素（px）。0 < StartH <= 1 表示相对值> 1 表示绝对值。0.9EndString否特效结束时，画框左上角在原始素材中的位置（横坐标、纵坐标、宽度、高度）, 以英文逗号隔开，皆非必填。"EndX,EndY,EndW,EndH"限制：0 < EndX + EndW <=10 < EndY + EndH <=1"0,0,1,1"EndXFloat否特效结束时，画框左上角在原始素材中的横坐标，单位：像素（px）。0 <= StartX < 1 表示相对值>= 1 表示绝对值。0EndYFloat否特效结束时，画框左上角在原始素材中的纵坐标，单位：像素（px）。0 <= StartY < 1 表示相对值>= 1 表示绝对值。0EndWFloat否特效结束时，画框在原始素材中的宽度，单位：像素（px）。0 < StartW <= 1 表示相对值> 1 表示绝对值。1EndHFloat否特效结束时，画框在原始素材中的高度，单位：像素（px）。0 < StartH <= 1 表示相对值> 1 表示绝对值。1Effect Type:ADenoise 音频降噪视频轨道中包含音频的视频或者音频轨道中的音频，支持进行降噪处理。名称类型是否必填描述ModeInteger否0：不处理（默认） 1：幅度较小的降噪2：保护音乐去除平稳噪声，适合音乐类内容3：强力去除平稳噪声，适合演讲类无音乐内容4：语音提取，去除平稳和非平稳噪声，适合非音乐内容Effect Type: Zoom 变焦为对应的素材 Clip 增加变焦效果。名称类型是否必填描述StartRateFloat否起始缩放比率默认值：1.0取值范围：[1.0, 5.0]EndRateFloat否结束缩放比率默认值：StartRate + 0.3取值范围：[StartRate, 5.0]DurationFloat否效果持续时长默认值：当前 Clip 渲染时长取值范围：[0, 当前 Clip 渲染时长]Effect Type: Harmonization 背景融合为对应的素材 Clip 增加背景融合效果，主要适用于数字人视频 Clip，当为数字人视频 Clip 添加此 Effect 后，会自适应背景图片的光线、明暗、冷暖等效果，减少数字人视频 Clip 与背景图片的结合时的“突兀”感。本 Effect 没有其它入参。Effect Type：ALoudNorm 音量归一ALoudNorm只适用于单个音视频素材。如果您有多个音视频素材，且希望它们的响度相同，您可能需要在每个素材上分别配置ALoudNorm。时间线示例：音量归一名称类型是否必填描述LoudnessFloat否目标响度，决定了音量的大小，符合ebur128度量；取值范围[-70.0,-5.0]，默认值为-24.0；TruePeakFloat否真峰值电平，限制音频信号的最高峰值电平；取值范围[-9.0,+0.0]，默认值-2.0；Effect Type: AEqualize 音量均衡适用于特效轨，为全局特效。其功能是对于全局音频进行统一的音量均衡处理。时间线示例：音量均衡名称类型是否必填描述PeakFloat否音频目标峰值。默认值为0.95，不建议超过该值。取值 (0,1) 两边开区间。GainFloat否设置最大增益系数。范围从1.0到100.0。默认值为10.0。动态音频标准化器确定每个输入帧的最大可能（局部）增益因子，即不会导致削波或失真的最大增益因子。