Place a rendered overlay on the timeline
add_overlayAdd a rendered clip to a CapCut project as a separate overlay track, with control over start time and duration. CapCut can remain closed.
Instructions
Adds an already-rendered clip to a CapCut project on its own track. Requires CapCut to be closed.
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": "<project>",
"file": "<file>",
"startSeconds": "<startSeconds>"
},
"name": "add_overlay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Absolute path to the rendered overlay | |
| project | Yes | Path to the project folder or its draft_content.json | |
| trackName | No | Defaults to "overlays" | |
| startSeconds | Yes | ||
| durationSeconds | No |