剪映Install

Summary

Add a visual effect to a video draft in Jianying by specifying its type, category, timing, track, canvas size, and optional parameters.

Inputs

• draftId (required) — The ID of the draft to which the effect will be added.
• effectType (required) — The name of the effect type to add (e.g., fade-in, fade-out, MV cover).
• effectCategory (required) — The category of the effect, either 'scene' (场景特效) or 'character' (人物特效).
• start — Start time in seconds where the effect begins in the draft (default is 0).
• end — End time in seconds where the effect ends; 0 means until the end of the draft (default is 0).
• trackName — Name of the track to add the effect to, used to differentiate tracks.
• effectParamsArray — Comma-separated list of numeric parameters specific to the effect, parsed into an array.
• effectWidth — Canvas width in pixels for the effect (default 1080).
• effectHeight — Canvas height in pixels for the effect (default 1920).
• jsonParameters — Optional JSON string to provide all parameters at once, overriding single parameter inputs.

Output shape

a JSON object representing the updated draft or the effect addition result

The response is returned as an array of JSON objects, one per input item, containing the API result for the add effect operation. Errors are included per item if continueOnFail is enabled.