add_effect

POST

/add_effect

Add effect

Request

Header Params

Body Params application/json

Example

{
    "effect_type": "Heart_Kisses",  // Name of the effect type (Required, must be selected from the system-supported effect list, e.g., Heart_Kisses)
    "start": 0,  // Effect start time (seconds, Optional, default 0)
    "end": 3.0,  // Effect end time (seconds, Optional, default 3.0)
    "draft_id": "draft_789",  // Draft ID (Optional, specifies the target draft to which the effect will be added. If not provided or the corresponding draft does not exist, a new draft may be created automatically)
    "track_name": "effect_01",  // Effect track name (Optional, default "effect_01", used to distinguish different effect tracks)
    "params": [35,45],  // List of effect parameters (Optional, parameters not provided will use default values. Specific parameters depend on the effect type)
    "width": 1080,  // Canvas width (Optional, default 1080)
    "height": 1920  // Canvas height (Optional, default 1920)
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.capcutapi.top/cut_capcut/add_effect' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "effect_type": "Heart_Kisses",  // Name of the effect type (Required, must be selected from the system-supported effect list, e.g., Heart_Kisses)
    "start": 0,  // Effect start time (seconds, Optional, default 0)
    "end": 3.0,  // Effect end time (seconds, Optional, default 3.0)
    "draft_id": "draft_789",  // Draft ID (Optional, specifies the target draft to which the effect will be added. If not provided or the corresponding draft does not exist, a new draft may be created automatically)
    "track_name": "effect_01",  // Effect track name (Optional, default "effect_01", used to distinguish different effect tracks)
    "params": [35,45],  // List of effect parameters (Optional, parameters not provided will use default values. Specific parameters depend on the effect type)
    "width": 1080,  // Canvas width (Optional, default 1080)
    "height": 1920  // Canvas height (Optional, default 1920)
}'

Responses

🟢200OK

application/json

Body

Example

{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1753846181_5cf8cf6a",
        "draft_url": "https://www.capcutapi.top/draft/downloader?draft_id=dfd_cat_1753846181_5cf8cf6a"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}

Modified at 2025-08-07 09:30:56

get_video_character_effect_types

create_draft