place_voiceover
Places a voiceover file on the first free audio track at the playhead or a set time, then ducks music only under spoken sections with editable volume keyframes and short fades.
Instructions
Put a voiceover file on the timeline (at the playhead or at seconds) on the first free audio track and duck the music under it: Volume keyframes only where the voice actually speaks (silences longer than 0.35 s let the music back up), with short fades. Music = audio-only clips on other tracks, or the tracks in duckTracks. Keyframes stay editable in Effect Controls. To record a voice first, use a text-to-speech tool or skill.
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": {
"file": "<file>"
},
"name": "place_voiceover"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Timeline seconds (default: playhead) | |
| file | Yes | Voiceover audio file | |
| track | No | Audio track for the voice (default: first free one) | |
| duckDb | No | Music change under the voice in dB (default -10) | |
| voGainDb | No | Voice clip level in dB | |
| silenceDb | No | Silence threshold for the voice (default -35) | |
| duckTracks | No | Audio tracks to duck (default: music clips) | |
| sequenceId | No | Sequence ID (GUID). | |
| fadeSeconds | No | Duck fade (default 0.25) | |
| sequenceName | No | Sequence name. Default: the active sequence. |