capcut_add_sound_effect
Add a sound effect to a CapCut project at an exact timeline timestamp, aligning audio cues with visual keyframes or text pops.
Instructions
Drops a transient sound effect (whoosh, pop, click, riser impact) at an exact timeline timestamp, aligned with visual keyframes or text pops.
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>",
"sfx_file_path": "<sfx_file_path>",
"timestamp_seconds": "<timestamp_seconds>"
},
"name": "capcut_add_sound_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| volume | No | SFX volume multiplier (default 0.7). | |
| track_index | No | Audio track index for SFX (default track 1). | |
| sfx_file_path | Yes | Absolute path to sound effect audio file (.wav, .mp3). | |
| timestamp_seconds | Yes | Timeline timestamp in seconds where the SFX should trigger. | |
| project_name_or_id | Yes | Target project name or ID. |