Effects define transformations applied to clips in a timeline. Each effect type provides a distinct set of parameters that control its behavior, positioning, timing, and appearance.
Effect type overview
The following table lists all available effect types and their primary functions.
Effect type | Description |
| Adds banner text (subtitles) to the output video. |
| Removes watermarks by blurring a specified area. |
| Crops the clip to a specified rectangular region. |
| Scales the clip to a specified size. |
| Adds padding around the clip image. |
| Configures background blur or color when clip and output sizes do not match. |
| Adds a transition between two adjacent clips. |
| Adds a frame-interpolated transition that preserves the output duration. |
| Applies visual effects, including mask effects. |
| Applies color filters and color grading. |
| Adjusts the volume gain of a clip. |
| Adds audio fade in or fade out. |
| Generates subtitles from audio using speech recognition. |
| Rotates a clip by 90°, 180°, or 270°. |
| Extracts subjects from green or blue backgrounds. |
| Extracts human figures from live-action scenes. |
| Intelligently removes station logos from videos. |
| Randomly clips a time segment from the original clip. |
| Flips a video or image horizontally or vertically. |
| Applies a Ken Burns panning and zooming effect. |
| Reduces audio noise. |
| Adds a zoom effect to a clip. |
| Adapts digital human video clips to background lighting and color. |
| Normalizes audio loudness. |
| Applies global loudness equalization. |
| Freezes the last frame of a video clip. |
Text and subtitle effects
Effect type: Text (banner text)
Timeline example: Subtitles and subtitle templates
Positioning and timing
Name | Type | Required | Description |
| Float | No | The horizontal distance between the upper-left corner of the banner text and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. This coordinate is scaled based on the clip size and the output video size. |
| Float | No | The vertical distance between the upper-left corner of the banner text and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. This coordinate is scaled based on the clip size and the output video size. |
| Float | No | The horizontal distance between the upper-left corner of the banner text and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. This coordinate is not scaled based on the clip size and the output video size. |
| Float | No | The vertical distance between the upper-left corner of the banner text and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. This coordinate is not scaled based on the clip size and the output video size. |
| Float | No | The start position of the banner text on the timeline. Unit: seconds, accurate to four decimal places. If you leave this parameter empty, the value is the same as the |
| Float | No | The end position of the banner text on the timeline. Unit: seconds, accurate to four decimal places. If you leave this parameter empty, the value is the same as the |
Text content and font
Name | Type | Required | Description |
| String | Yes | The content of the banner text. |
| String | No | The font of the banner text. For the supported fonts, see Font list. Default value: |
| Int | Yes | The font size of the banner text. This font size is scaled based on the clip size and the output video size. Default value: 0. Maximum value: 5000. Specify only one of |
| Int | Yes | The font size of the banner text. This font size is not scaled based on the clip size and the output video size. Specify only one of |
| String | No | The method used to calculate the actual rendered text size from the font size. Default value: |
| String | No | The path to a custom font file in your OSS bucket. TTF, OTF, and WOFF formats are supported. Example: |
Text appearance
Name | Type | Required | Description |
| String | No | The color of the banner text, in the format of a number sign (#) followed by a hexadecimal value. Example: #ffffff. |
| String | No | The opacity of the banner text. Valid values: 0 to 1. A value of 1 indicates opaque. A value of 0 indicates fully transparent. Default value: 1. |
|
| No | The font appearance of the banner text. |
| Integer | No | The character spacing of the banner text. Unit: pixels. Default value: 0. |
| Integer | No | The line spacing of the banner text. Unit: pixels. Default value: 0. |
| Float | No | The counterclockwise rotation angle of the banner text. Unit: degrees. Default value: 0. |
| Int | No | The border and shadow style of the banner text. Valid values: 1 (border and shadow) and 3 (opaque background box). Default value: 1. |
| Int | No | The outline width of the banner text. Unit: pixels. Default value: 0. |
| String | No | The outline color of the banner text, in the format of a number sign (#) followed by a hexadecimal value. Example: #ffffff. |
| Int | No | The depth of the shadow cast by the banner text. Unit: pixels. Default value: 0. |
| String | No | The shadow color of the banner text, in the format of a number sign (#) followed by a hexadecimal value. Example: #ffffff. |
Alignment and adaptation
Name | Type | Required | Description |
| String | No | The positioning and alignment mode of the banner text. Default value: |
| String | No | Specifies whether the banner text automatically wraps or scales when it exceeds the video width or the specified |
| String | No | The width of the subtitle text box. This parameter takes effect when |
| Boolean | No | Specifies whether the font size, outline size, and shadow size of a local subtitle style are scaled based on the output video size and the |
| Boolean | No | Specifies whether to enable bidirectional text rendering. Enable this feature when subtitle text contains both left-to-right (LTR) text such as English, digits, and Latin letters, and right-to-left (RTL) text. Default value: false. |
Animation and effects
Name | Type | Required | Description |
| String | No | The artistic text style type of the banner text. For more information, see Word art. |
| String | No | The subtitle texture effect. PNG, JPG, JPEG, and BMP formats are supported. Only OSS files are supported. Example: |
| String | No | The entrance effect type of the banner text. For more information, see Subtitle effect examples. |
| Float | No | The duration of the entrance effect. Unit: seconds, accurate to four decimal places. Default value: 0.5. If the text duration is less than 0.5, the value is the total duration minus the exit effect duration. |
| String | No | The exit effect type of the banner text. For more information, see Subtitle effect examples. |
| Float | No | The duration of the exit effect. Unit: seconds, accurate to four decimal places. Default value: 0.5. If the text duration is less than 0.5, the value is the total text duration. |
| String | No | The loop effect type of the banner text. This parameter cannot take effect together with the subtitle entrance effect or exit effect. For more information, see Subtitle effect examples. |
| Float | No | The playback speed of the loop effect, accurate to four decimal places. Default value: 1. A value greater than 1 indicates an accelerated loop. A value less than 1 indicates a slowed-down loop. |
| No | The multi-layer effects of the banner text. Multi-layer outlines, multi-layer shadows, Gaussian blur (supported only when the type is shadow), and subtitle background effects are supported. If you specify |
Bubble text
Name | Type | Required | Description |
| String | No | The bubble text style type. For the bubble types and effects, see Text bubble effect examples. |
| Float | No | The width of the bubble background image relative to the output video. This parameter takes effect only when bubble text is used. A value greater than 1 specifies absolute pixels. A value less than or equal to 1 specifies a relative value. |
| Float | No | The height of the bubble background image relative to the output video. This parameter takes effect only when bubble text is used. A value greater than 1 specifies absolute pixels. A value less than or equal to 1 specifies a relative value. |
Effect type: AI_ASR (speech-to-text)
Generates subtitles based on audio. You can place this effect in the Effects array of a video track or an audio track. The parameters are the same as those in . By default, the subtitles are centered at the bottom of the video.
This effect can be called only in the Beijing, Shanghai, and Hangzhou regions.
Timeline example: Use AI_ASR to convert speech to text and merge the captions into a video
Name | Type | Required | Description |
| Float | No | The horizontal distance between the upper-left corner of the banner text and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. |
| Float | No | The vertical distance between the upper-left corner of the banner text and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. |
| String | No | The font of the banner text. For the supported fonts, see Font list. Default value: |
| Int | Yes | The font size of the banner text. |
| String | No | The color of the banner text, in the format of a number sign (#) followed by a hexadecimal value. Example: #ffffff. |
| String | No | The opacity of the banner text. Valid values: 0 to 1. A value of 1 indicates opaque. A value of 0 indicates fully transparent. Default value: 1. |
|
| No | The font appearance of the banner text. |
| Boolean | No | Specifies whether to enable automatic highlighting for ASR subtitles. |
| No | The style of the highlighted subtitles. | |
| String | No | The subtitle timing text. After you specify this parameter, the ASR recognition result is aligned with the provided text, and sentences are automatically split and filled into the corresponding time positions. |
Video effects
Effect type: DeWatermark (watermark removal)
Name | Type | Required | Description |
| Float | No | The horizontal distance between the upper-left corner of the blurred area and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. |
| Float | No | The vertical distance between the upper-left corner of the blurred area and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. |
| Float | Yes | The width of the blurred area in the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. |
| Float | Yes | The height of the blurred area in the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. |
Effect type: Crop
Timeline example: Crop a video
Name | Type | Required | Description |
| Float | No | The horizontal distance between the upper-left corner of the retained area after cropping and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. |
| Float | No | The vertical distance between the upper-left corner of the retained area after cropping and the upper-left corner of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. Default value: 0. |
| Float | Yes | The width of the retained area after cropping in the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 2 specifies absolute pixels. |
| Float | Yes | The height of the retained area after cropping in the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 2 specifies absolute pixels. |
Effect type: Scale
If the Scale effect is not specified and the width and height of the clip image do not match those of the output video, the clip image is automatically scaled until its width or height matches the output image. Black bars are automatically added to the top and bottom or to the left and right, and the clip image is centered.
Timeline example: Scale modes
Name | Type | Required | Description |
| Float | Yes | The width of the retained area after scaling in the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 1 specifies absolute pixels. |
| Float | Yes | The height of the retained area after scaling in the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 1 specifies absolute pixels. |
Effect type: Pad (padding)
If the Pad effect is not specified and the aspect ratio of the clip image does not match that of the output video, the clip image is automatically scaled until its width or height matches the output image. Black bars are automatically added to the top and bottom or to the left and right, and the clip image is centered.
Timeline example: Convert a landscape video to portrait and add blurred areas
Name | Type | Required | Description |
| Float | No | The distance between the left edge of the clip image and the left edge of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 1 specifies absolute pixels. |
| Float | No | The distance between the right edge of the clip image and the right edge of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the width of the output video. An integer value greater than or equal to 1 specifies absolute pixels. |
| Float | No | The distance between the top edge of the clip image and the top edge of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 1 specifies absolute pixels. |
| Float | No | The distance between the bottom edge of the clip image and the bottom edge of the output video. Both percentage and pixel formats are supported. A value in the range of [0, 0.9999] specifies the ratio relative to the height of the output video. An integer value greater than or equal to 1 specifies absolute pixels. |
| String | No | The padding color, in the format of a number sign (#) followed by a hexadecimal value. Example: #000000. Default value: black. |
Effect type: Background (background settings)
Background settings include background blur and background color. When the clip size and the output video size do not match, you can use this effect to configure the blank area. Background settings can be used together with effects such as crop, scale, visual effect, and transition.
Timeline example: Convert a landscape video to portrait and set the background color
Name | Type | Required | Description |
| String | Yes | The background subtype. Valid values: |
| Float | No | The blur radius. This parameter takes effect when |
| String | No | The background color value, expressed as a hexadecimal RGB color. This parameter takes effect when |
Effect type: Rotate (clip rotation)
Rotates a clip by a specific angle. Only 90°, 180°, and 270° rotations are supported. You can place this effect in the Effects array of a clip in a video track or an image track.
Timeline example: Rotate a material
Name | Type | Required | Description |
| Integer | Yes | The clockwise rotation angle of the clip. Valid values: 90, 180, and 270. |
Effect type: Flip
Flips a video or image in a video track horizontally or vertically.
Timeline example: Horizontal and vertical flips
Name | Type | Required | Description |
| String | Yes | The flip direction. Valid values: |
Effect type: VFX (visual effect)
Timeline example: Visual effects
Name | Type | Required | Description |
| String | Yes | The visual effect subtype. You can specify multiple subtypes separated by commas (,), and one of them is randomly selected. You can also specify |
| Float | No | Supported only when |
| Float | No | Supported only when |
| Float | No | Supported only when |
| Float | No | Supported only when |
| String | No | The extended parameters of the visual effect. This parameter takes effect only when |
Mask examples and output video effects: Mask effects
For the following mask parameters, if the parameter type is float, you must specify the value strictly in float format, such as 0.5 or 2.0.
Circular mask parameters
SubType = mask_circle
Parameter | Type | Valid values | Default value | Description |
| float | [0.0, clip width] | 0.5 | The X coordinate of the center of the mask circle in the clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip width. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip height] | 0.5 | The Y coordinate of the center of the mask circle in the clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip height. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip width] | 0.8 | The width of the mask ellipse, relative to the clip width. A value in the range of [0.0, 1.0] specifies a width relative to the clip width. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip height] | 0.8 | The height of the mask ellipse, relative to the clip height. A value in the range of [0.0, 1.0] specifies a height relative to the clip height. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, 1.0] | 0.1 | The antialiasing parameter of the mask ellipse. A larger value results in a higher degree of edge feathering. |
| float | [-9999.0, 9999.0] | 0.0 | The rotation angle. |
| float | [0.0, 1.0] | 0 | The blur intensity inside the mask. A value of 0.0 disables blur. A larger value results in a higher degree of blur in the mask area. |
| float | [0.0, 1.0] | 0 | The opacity of the area outside the mask. A value of 0.0 indicates that the area outside the mask is fully transparent. A value of 1.0 indicates that the original image outside the mask is fully retained. A value in between indicates semi-transparent retention. |
Rectangular mask parameters
SubType = mask_rec
Parameter | Type | Valid values | Default value | Description |
| float | [0.0, clip width] | 0.5 | The X coordinate of the center of the mask rectangle in the video clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip width. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip height] | 0.5 | The Y coordinate of the center of the mask rectangle in the video clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip height. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip width] | 0.8 | The width of the mask rectangle. A value in the range of [0.0, 1.0] specifies a width relative to the clip width. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip height] | 0.8 | The height of the mask rectangle. A value in the range of [0.0, 1.0] specifies a height relative to the clip height. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, 1.0] | 0.1 | The antialiasing parameter of the mask rectangle. A larger value results in a higher degree of edge feathering. |
| float | [0.0, the greater of the clip width and height] | 0.1 | The corner radius of the mask rectangle. A value in the range of [0.0, 1.0] specifies a radius relative to the greater of the clip width and height. A value greater than 1.0 specifies absolute pixels. |
| float | [-9999.0, 9999.0] | 0.0 | The rotation angle. |
| float | [0.0, 1.0] | 0 | The blur intensity inside the mask. A value of 0.0 disables blur. A larger value results in a higher degree of blur in the mask area. |
| float | [0.0, 1.0] | 0 | The opacity of the area outside the mask. A value of 0.0 indicates that the area outside the mask is fully transparent. A value of 1.0 indicates that the original image outside the mask is fully retained. A value in between indicates semi-transparent retention. |
Linear mask parameters
SubType = mask_linear
Parameter | Type | Valid values | Default value | Description |
| float | [0.0, clip width] | 0.5 | The X coordinate of the center reference point of the linear mask in the clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip width. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip height] | 0.5 | The Y coordinate of the center reference point of the linear mask in the video clip, relative to the upper-left corner of the video. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip height. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, 1.0] | 0.1 | The antialiasing parameter of the linear mask. A larger value results in a higher degree of edge feathering. |
| float | [-9999.0, 9999.0] | 0.0 | The rotation angle. |
| float | [0.0, 1.0] | 0 | The blur intensity inside the mask. A value of 0.0 disables blur. A larger value results in a higher degree of blur in the mask area. |
| float | [0.0, 1.0] | 0 | The opacity of the area outside the mask. A value of 0.0 indicates that the area outside the mask is fully transparent. A value of 1.0 indicates that the original image outside the mask is fully retained. A value in between indicates semi-transparent retention. |
Mirror mask parameters
SubType = mask_minor
Parameter | Type | Valid values | Default value | Description |
| float | [0.0, clip width] | 0.5 | The X coordinate of the center reference point of the mirror mask in the clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip width. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, clip height] | 0.5 | The Y coordinate of the center reference point of the mirror mask in the clip, relative to the upper-left corner of the clip. A value in the range of [0.0, 1.0] specifies a coordinate relative to the clip height. A value greater than 1.0 specifies absolute pixels. |
| float | [0.0, 1.0] | 0.1 | The antialiasing parameter of the mirror mask. A larger value results in a higher degree of edge feathering. |
| float | [-9999.0, 9999.0] | 0.0 | The rotation angle. |
| float | [0.0, 1.0] | 0 | The blur intensity inside the mask. A value of 0.0 disables blur. A larger value results in a higher degree of blur in the mask area. |
| float | [0.0, 1.0] | 0 | The opacity of the area outside the mask. A value of 0.0 indicates that the area outside the mask is fully transparent. A value of 1.0 indicates that the original image outside the mask is fully retained. A value in between indicates semi-transparent retention. |
Effect type: Filter
Timeline example: Filters
Name | Type | Required | Description |
| String | Yes | The filter subtype. You can specify multiple subtypes separated by commas (,), and one of them is randomly selected. You can also specify |
| Float | No | The start position of the filter on the timeline. Unit: seconds, accurate to four decimal places. If you leave this parameter empty, the value is the same as the |
| Float | No | The end position of the filter on the timeline. Unit: seconds, accurate to four decimal places. If you leave this parameter empty, the value is the same as the |
| String | No | The extended parameters of the filter. This parameter takes effect only when |
Color grading filter parameters
Timeline example: Use a color filter
Parameter | Type | Valid values | Default value | Description |
| int | [-255, 255] | 0 | The brightness adjustment. |
| int | [-100, 100] | 0 | The contrast adjustment. |
| int | [-100, 100] | 0 | The saturation adjustment. |
| int | [1000, 40000] | 6000 | The color temperature. Takes effect together with |
| int | [0, 100] | 0 | The color temperature ratio. |
| int | [-100, 100] | 0 | The tint adjustment. |
| int | [0, 100] | 0 | The vignette ratio. |
Effect type: Zoom
Adds a zoom effect to the corresponding clip. This effect is supported only for clips in a VideoTrack.
Name | Type | Required | Description |
| Float | No | The start zoom ratio. Default value: 1.0. Valid values: [1.0, 5.0]. |
| Float | No | The end zoom ratio. Default value: |
| Float | No | The duration of the effect. Default value: the rendering duration of the current |
Effect type: KenBurns (Ken Burns effect)
Applies a Ken Burns effect to a video or image in a video track.
Considerations:
This effect applies to images and videos, and can be used together with
VFX, filters, and transitions.This effect supports setting the width and height of the output image (see the
WindowWandWindowHparameters). Therefore, it cannot be used together with theCrop,Scale,Pad, orBackgroundeffect.
Timeline example: Ken Burns
Name | Type | Required | Description | Example |
| Float | No | The duration of the effect. Default value: the clip duration. Maximum value: 10. Unit: seconds. | 5 |
| Float | No | The image width of the final output segment. Default value: the width of the output video. Unit: pixels. A value in the range of (0, 1] specifies a relative value. A value greater than 1 specifies an absolute value. | 1 |
| Float | No | The image height of the final output segment. Default value: the height of the output video. Unit: pixels. A value in the range of (0, 1] specifies a relative value. A value greater than 1 specifies an absolute value. | 1 |
| String | No | The position of the upper-left corner of the frame in the original clip when the effect starts. Format: " | "0,0,0.9,0.9" |
| Float | No | The X coordinate of the upper-left corner of the frame in the original clip when the effect starts. A value in the range of [0, 1) specifies a relative value. A value greater than or equal to 1 specifies absolute pixels. | 0 |
| Float | No | The Y coordinate of the upper-left corner of the frame in the original clip when the effect starts. A value in the range of [0, 1) specifies a relative value. A value greater than or equal to 1 specifies absolute pixels. | 0 |
| Float | No | The width of the frame in the original clip when the effect starts. A value in the range of (0, 1] specifies a relative value. A value greater than 1 specifies absolute pixels. | 0.9 |
| Float | No | The height of the frame in the original clip when the effect starts. A value in the range of (0, 1] specifies a relative value. A value greater than 1 specifies absolute pixels. | 0.9 |
| String | No | The position of the upper-left corner of the frame in the original clip when the effect ends. Format: " | "0,0,1,1" |
| Float | No | The X coordinate of the upper-left corner of the frame in the original clip when the effect ends. A value in the range of [0, 1) specifies a relative value. A value greater than or equal to 1 specifies absolute pixels. | 0 |
| Float | No | The Y coordinate of the upper-left corner of the frame in the original clip when the effect ends. A value in the range of [0, 1) specifies a relative value. A value greater than or equal to 1 specifies absolute pixels. | 0 |
| Float | No | The width of the frame in the original clip when the effect ends. A value in the range of (0, 1] specifies a relative value. A value greater than 1 specifies absolute pixels. | 1 |
| Float | No | The height of the frame in the original clip when the effect ends. A value in the range of (0, 1] specifies a relative value. A value greater than 1 specifies absolute pixels. | 1 |
Effect type: FreezeFrame (freeze frame)
Applies freeze-frame processing to the last frame of a video clip. This effect applies only to video clips in a video track. It does not apply to image clips in a video track or to clips in an audio track.
This effect cannot be used together with a transition. For more information, see .
Timeline example: Video freeze frame
Name | Type | Required | Description |
| Float | No | The freeze-frame duration. Default value: 0. Unit: seconds. |
Transition effects
Effect type: Transition
A transition overlaps the layers of two adjacent clips within the same period of time, which shortens the duration of the output video. To avoid a shortened duration, use the DLTransition (frame-interpolated transition) effect.
A transition effect is placed between two clips. You only need to set the transition duration for the preceding clip. The transition applies to the end of the preceding clip and the beginning of the following clip. During the transition, the video images are overlaid, so the total duration is reduced by an amount equal to the transition duration.
For example, a video track contains two clips: Clip1 (10 seconds) and Clip2 (8 seconds). If you add a 4-second transition between Clip1 and Clip2, the total duration of the video track decreases from 18 seconds to 14 seconds.
For the available transition effects, see Transition effect examples.
Timeline example: Transition timeline configuration example
Name | Type | Required | Description |
| String | Yes | The transition subtype. You can specify multiple subtypes separated by commas (,), and one of them is randomly selected. You can also specify |
| Float | No | The duration of the transition effect. Unit: seconds, accurate to four decimal places. Default value: 1. |
Effect type: DLTransition (frame-interpolated transition)
Unlike the standard Transition, DLTransition (Duration Lock Transition) fills the transition with freeze frames so that the duration of the output video is not shortened.
The parameters are used in the same way as those of the Transition effect.
Name | Type | Required | Description |
| String | Yes | The transition subtype. You can specify multiple subtypes separated by commas (,), and one of them is randomly selected. You can also specify |
| Float | No | The duration of the transition effect. Unit: seconds, accurate to four decimal places. Default value: 1. |
Audio effects
Effect type: Volume (volume adjustment)
Timeline examples: Mute an entire video, Example of adjusting the volume of a video and the volume of an audio clip
Name | Type | Required | Description |
| Float | Yes | The volume gain. Valid values: 0 to 10. A value of 0 indicates mute. A value of 1 indicates the original volume. A value less than 1 indicates a volume lower than the original volume. A value greater than 1 indicates a volume higher than the original volume. Do not set an excessively large volume gain, which may cause audio distortion. |
Effect type: AFade (audio fade in and fade out)
Timeline example: Configure fade in and fade out for an audio-only clip and for the audio in a video clip
Name | Type | Required | Description |
| String | Yes | The fade subtype. Valid values: |
| Float | No | The duration of the fade in or fade out. Fade in applies to the beginning of the clip. Fade out applies to the end of the clip. Default value: 0, which indicates that fade in and fade out do not take effect. |
| String | No | The volume curve of the fade effect. Default value: |
Effect type: ADenoise (audio noise reduction)
Reduces noise for audio in a video track or an audio track.
Name | Type | Required | Description |
| Integer | No | The noise reduction mode. Valid values: 0 (no processing, default), 1 (noise reduction with a small amplitude), 2 (removes stationary noise while protecting music, suitable for music content), 3 (strongly removes stationary noise, suitable for speech content without music), 4 (speech extraction, removes both stationary and non-stationary noise, suitable for non-music content). |
Effect type: ALoudNorm (loudness normalization)
ALoudNorm applies only to a single audio or video clip. If you have multiple audio or video clips and want them to have the same loudness, configure ALoudNorm separately for each clip.
This effect applies only to audio and video clips. If ALoudNorm is used together with ADenoise or Volume, the application order is: ADenoise > Volume > ALoudNorm.
Timeline example: Normalize audio
Name | Type | Required | Description |
| Float | No | The target loudness, which determines the volume level and complies with the EBU R128 measurement. Valid values: [-70.0, -5.0]. Default value: -24.0. |
| Float | No | The true peak level, which limits the highest peak level of the audio signal. Valid values: [-9.0, +0.0]. Default value: -2.0. |
Effect type: AEqualize (loudness equalization)
Applies uniform loudness equalization to the global audio. This effect applies to the effect track and is a global effect. It is not supported for a single clip.
Timeline example: Equalize the volume
Name | Type | Required | Description |
| Float | No | The target peak of the audio. Default value: 0.95. Do not exceed this value. Valid values: (0, 1). |
| Float | No | The maximum gain factor. Valid values: 1.0 to 100.0. Default value: 10.0. The dynamic audio normalizer determines the maximum possible (local) gain factor for each input frame, that is, the maximum gain factor that does not cause clipping or distortion. |
AI-powered effects
Effect type: AI_Matting (image matting)
Extracts the subject from a green or blue background color and overlays it on another background video or image.
This effect can be called only in the Beijing, Shanghai, and Hangzhou regions.
Timeline example: AI_Matting: Green screen matting
Name | Type | Required | Description |
| String | Yes | The background color. Only green (image matting) and blue (blue screen matting) are supported. |
| Integer | Yes | Specifies whether the background color is automatically determined. Valid values: 0 (determined based on the threshold), 1 (automatically determined). |
| Float | No | The threshold for determining the background color. A larger value results in a more lenient determination. Valid values: [0, 10]. |
Effect type: AI_RealMatting (live-action matting)
Extracts the human figure in a video from a live-action scene and overlays it on another background video or image.
This effect can be called only in the Beijing, Shanghai, and Hangzhou regions.
Timeline example: AI_RealMatting: Background replacement
Name | Type | Required | Description |
| Float | No | The threshold for determining the background color. A larger value results in a more lenient determination. Valid values: [0, 10]. Default value: 2. |
Effect type: AI_Delogo (intelligent logo removal)
Intelligently identifies and removes the station logo in a video.
This effect can be called only in the Beijing and Shanghai regions.
Effect type: Harmonization (background harmonization)
Adds a background harmonization effect to the corresponding clip. This effect applies mainly to digital human video clips. After you add this effect to a digital human video clip, the effect adapts to the lighting, brightness, and color temperature of the background image, which reduces the visual mismatch between the digital human video clip and the background image.
This effect is supported only for clips in a
VideoTrack.Only one background harmonization effect can be added in a single editing request.
This effect has no additional input parameters.
Other effects
Effect type: Clip (random clipping)
The clipping feature. Only random clipping is supported. A time segment is randomly clipped from the original clip and inserted into the timeline.
Name | Type | Required | Description |
| String | Yes | The clipping type. Only random clipping is supported: |
| Float | Yes | The duration of the clipped segment. |