Add audio clip
add_audioAdd an audio file (music or voiceover) to a CapCut draft at a specific timeline position with optional duration, source start, and volume settings.
Instructions
Adds an audio file (music, voiceover) to a draft audio 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>",
"path": "<path>"
},
"name": "add_audio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path to the audio file (supports ~). | |
| draft | Yes | Target draft name. | |
| volume | No | Clip volume, 0..2. Default 1. | |
| atSeconds | No | Timeline position in seconds. Defaults to the end of the track. | |
| durationSeconds | No | Clip length in seconds. Defaults to the full audio. | |
| sourceStartSeconds | No | Where the clip starts inside the source audio. Default 0. |