add_video_keyframe

POST

/add_video_keyframe

Add keyframes to the specified track and support batch operations.

Request

Header Params

Body Params application/json

Example

{
    "draft_id": "dfd_cat_1753709045_3a033ea7",  // Draft ID (Required, specifies the draft to operate on)
    "track_name": "video_main",  // Track name (Optional, default "video_main", specifies the track to which keyframes will be added)
    
    // Single keyframe parameters (for backward compatibility, used to add a single keyframe)
    "property_type": "alpha",  // Property type (Optional, default "alpha" for opacity, optional values include "scale_x", "rotation", etc.)
    "time": 0.0,  // Keyframe time (seconds, Optional, default 0.0 seconds)
    "value": "1.0",  // Property value (Optional, default "1.0", type should be adjusted according to property_type, such as numbers, strings, etc.)
    
    // Batch keyframe parameters (new, preferred, used to add multiple keyframes at once)
    "property_types": ["alpha", "scale_x"],  // List of property types (Optional, array format, corresponding to times and values)
    "times": [0.0, 2.0],  // List of times (Optional, array format, corresponding to property_types and values)
    "values": ["1.0", "0.8"]  // List of values (Optional, array format, corresponding to property_types and times)
}

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_video_keyframe' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "draft_id": "dfd_cat_1753709045_3a033ea7",  // Draft ID (Required, specifies the draft to operate on)
    "track_name": "video_main",  // Track name (Optional, default "video_main", specifies the track to which keyframes will be added)
    
    // Single keyframe parameters (for backward compatibility, used to add a single keyframe)
    "property_type": "alpha",  // Property type (Optional, default "alpha" for opacity, optional values include "scale_x", "rotation", etc.)
    "time": 0.0,  // Keyframe time (seconds, Optional, default 0.0 seconds)
    "value": "1.0",  // Property value (Optional, default "1.0", type should be adjusted according to property_type, such as numbers, strings, etc.)
    
    // Batch keyframe parameters (new, preferred, used to add multiple keyframes at once)
    "property_types": ["alpha", "scale_x"],  // List of property types (Optional, array format, corresponding to times and values)
    "times": [0.0, 2.0],  // List of times (Optional, array format, corresponding to property_types and values)
    "values": ["1.0", "0.8"]  // List of values (Optional, array format, corresponding to property_types and times)
}'

Responses

🟢200OK

application/json

Body

Example

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

Modified at 2025-08-11 14:13:48

add_audio

get_video_scene_effect_types