add_keyframe
Insert or update a keyframe on a clip effect property at a specified sequence time to control animated changes in Premiere Pro.
Instructions
Add/update a keyframe. Time is the sequence time in seconds (must be inside the clip).
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": {
"trackType": "<trackType>",
"trackIndex": "<trackIndex>",
"clipIndex": "<clipIndex>",
"effect": "<effect>",
"property": "<property>",
"time": "<time>",
"value": "<value>"
},
"name": "add_keyframe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | Yes | ||
| value | Yes | New value. Position/Anchor Point are [x, y] in 0-1 frame units (or use set_clip_transform for pixels). | |
| effect | Yes | Effect name (e.g. 'Motion', 'Opacity', 'Gaussian Blur') or its index from get_clip_effects | |
| property | Yes | Property name (e.g. 'Scale', 'Position') or its index from get_clip_effects | |
| clipIndex | Yes | Clip index on the track, 0-based from the left (see get_timeline_clips) | |
| trackType | Yes | Track type | |
| trackIndex | Yes | Track index, 0-based (V1 = 0, A1 = 0) | |
| interpolation | No |