Place clip
place_clipCreates a new clip from an existing named region at a timeline position, on the track that owns the region (track only disambiguates same-named regions).
Instructions
Creates a new clip from an existing named region at a timeline position, on the track that owns the region (track only disambiguates same-named regions).
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": "<project>",
"region": "<region>",
"at": "<at>"
},
"name": "place_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | Timeline position for the new clip | |
| task | No | Name of the task this edit is part of, e.g. "remove speech pauses". In the open app, all edits with the same task name become one undo step: keep the name for every call of the task and change it when the next task starts. Without a task name, all edits of this session share one step | |
| unit | No | Unit for positions (default bars; bars/beats are 1-based, seconds/clocks absolute) | |
| track | No | Track id, to disambiguate same-named regions | |
| region | Yes | Name of the region to place | |
| project | Yes | Path to the .audium project package (absolute paths recommended) |