Add clip
add_clipPlace media on the timeline. Without start it is appended to the end of the main track. Picks/creates a free track automatically. With float, an image or video goes over the picture as its own layer instead (logo, product shot, screenshot, sticker): at its real size up to 60% of the frame, at start (default 0), on a track above the footage so nothing is pushed along. Position it with transform.
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": {
"mediaId": "<mediaId>"
},
"name": "add_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| in | No | source in-point (s) | |
| fit | No | ||
| crop | No | fractions 0–1 | |
| name | No | ||
| text | No | Text style | |
| float | No | layer it over the picture | |
| label | No | colour label shown on the timeline; null removes it | |
| speed | No | 0.1–16; changing speed keeps the source span | |
| start | No | timeline start (s) | |
| fadeIn | No | ||
| volume | No | 0 = mute, 1 = original, up to 4 | |
| fadeOut | No | ||
| filters | No | brightness -1..1 (0), contrast 0..3 (1), saturation 0..3 (1), blur px | |
| mediaId | Yes | ||
| opacity | No | ||
| overlap | No | with trackId: newTrack (default) layers it on a new track if the spot is taken; insert drops it in between the clips nearest start and closes the track up | |
| trackId | No | ||
| duration | No | timeline duration (s) | |
| projectId | No | Project to act on (default: the open one) | |
| transform | No | x/y: offset in project pixels from canvas center (+y is down). scale: 1 = fit. rotation: degrees |