capcut_add_audio
Add a specified audio file to a CapCut draft at a chosen track and timeline position, adjusting volume, speed, and duration.
Instructions
Add an audio clip at a time on a track.
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": "<draft>",
"file": "<file>"
},
"name": "capcut_add_audio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | ||
| posX | No | ||
| posY | No | ||
| atSec | No | start time on the timeline, seconds. Omit to append right after the last clip on the target track (no manual running-total math needed). | |
| draft | Yes | ||
| scale | No | ||
| speed | No | ||
| durSec | No | duration (default: full media length) | |
| volume | No | ||
| opacity | No | ||
| rotation | No | ||
| trackIndex | No | target track (index in the tracks list); a new track is made if omitted | |
| srcStartSec | No | in-point inside the source file, seconds | |
| trackRenderIndex | No | layer order; higher = on top |