studio.add_audio_to_timeline
Place an audio asset on a role track: 'audio-music' (background, default volume 0.3 — voice ducks music by role) or 'audio-voice' (narration, volume 1.0). It lands on the role's first track, or on the one track_id names (a second music bed, a second voice).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track | No | audio-music | |
| volume | No | 0-2; defaults 0.3 for music, 1.0 for voice. | |
| asset_id | Yes | ||
| track_id | No | An audio track (vtr_) from get_composition; its role wins when track is left out. Defaults to the role's first track. | |
| project_id | Yes | The studio project (vp_…) this tool acts on. | |
| start_time_ms | No |