Add Keyframe Animation to CapCut Draft
capcut_add_video_keyframeAdd property keyframes to a video track in a CapCut draft for animation. Specify properties like scale or opacity with timestamps and values to create effects such as zoom-ins or fades.
Instructions
Add property keyframes (scale, position, rotation, opacity, ...) to an existing track for animation.
Args:
draft_id (string, required): From capcut_create_draft.
track_name (string, required): Name of the track to animate.
property_types (string[], required): Properties to animate, e.g. ['scale_x', 'scale_y', 'alpha'].
times (number[], required): Keyframe timestamps in seconds — same length as values.
values (string[], required): Keyframe values matching each timestamp.
extra_params: Any additional VectCutAPI field not modeled above.
Returns: JSON confirming the keyframes were added.
Example: animate a zoom-in — property_types=['scale_x','scale_y'], times=[0,2], values=['1.0','1.5'].
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"draft_id": "<draft_id>",
"track_name": "<track_name>",
"property_types": "<property_types>",
"times": "<times>",
"values": "<values>"
},
"name": "capcut_add_video_keyframe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| times | Yes | Keyframe timestamps in seconds. Must be the same length as each value list. | |
| values | Yes | Keyframe values (as strings) matching each timestamp in `times`. | |
| draft_id | Yes | The draft_id returned by capcut_create_draft. | |
| track_name | Yes | Name of the track to animate (as returned/used when the clip was added). | |
| extra_params | No | Optional passthrough for advanced/undocumented VectCutAPI fields not modeled explicitly above (e.g. nested transform/animation objects). Merged directly into the request body. Check the VectCutAPI example.py / API docs if you need a field that isn't listed here. | |
| property_types | Yes | Properties to animate, e.g. ['scale_x', 'scale_y', 'alpha', 'rotation', 'position_x', 'position_y']. |