capcut_add_video_clip
Add video or image files to a CapCut project timeline with automatic duration and resolution detection. Supports positioning, scaling, opacity, rotation, and track assignment.
Instructions
Adds a video or image file to a CapCut video track. Media metadata (duration, resolution) is automatically probed.
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": {
"project_name_or_id": "<project_name_or_id>",
"file_path": "<file_path>"
},
"name": "capcut_add_video_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Horizontal position offset normalized [-1.0 to 1.0]. 0.0 is center. | |
| y | No | Vertical position offset normalized [-1.0 to 1.0]. 0.0 is center. | |
| scale | No | Scale multiplier (1.0 = 100%). | |
| opacity | No | Opacity/alpha from 0.0 to 1.0. | |
| rotation | No | Rotation in degrees. | |
| file_path | Yes | Absolute path to the video or image file on disk. | |
| track_index | No | Track index (0 = main track, 1+ = overlay / PIP tracks). | |
| duration_seconds | No | Clip duration in seconds. Defaults to full media length (or 3s for images). | |
| project_name_or_id | Yes | Target project name or ID. | |
| start_time_seconds | No | Start time on timeline in seconds, or 'auto_append' to append sequentially. | auto_append |
| source_start_seconds | No | Starting in-point within the source file in seconds. |