overlay_clip
Overlay a video, image, or text clip onto a base video with controls for position, opacity, and timing.
Instructions
Place one clip on top of another (text, watermark, picture-in-picture).
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": {
"base_clip_id": "<base_clip_id>",
"overlay_clip_id": "<overlay_clip_id>"
},
"name": "overlay_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Optional exact x position in pixels (top-left of overlay). | |
| y | No | Optional exact y position in pixels. | |
| opacity | No | 0.0 (invisible) to 1.0 (opaque). | |
| position | No | One of 'center', 'top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', 'bottom-right'. Ignored if x and y are given. | center |
| base_clip_id | Yes | The background/base video. | |
| start_seconds | No | When the overlay appears on the base timeline. | |
| overlay_clip_id | Yes | The clip to draw on top (video, image, or text clip). | |
| duration_seconds | No | How long it stays; defaults to overlay's duration. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||