Overlay Image or Video
overlayComposite an image or video onto a base video at a pixel position, optionally scale it and limit display time, while keeping the base audio and duration.
Instructions
Composite an image or video (logo, watermark, picture-in-picture) onto a video at a pixel position, optionally scaled and time-limited; keeps the base's audio and length.
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": {
"input": "<input>",
"overlay": "<overlay>",
"x": "<x>",
"y": "<y>"
},
"name": "overlay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Left, px. | |
| y | Yes | Top, px. | |
| end | No | Hide after this second. | |
| input | Yes | Path to the base video. | |
| shape | No | circle: centre square masked round (webcam). | |
| start | No | Show from this second. | |
| width | No | Scale to this width (other side keeps aspect). | |
| height | No | Scale to this height. | |
| output | No | Optional output path. Defaults under SCREENCAST_HOME/edits. | |
| overlay | Yes | Overlay image or video path. | |
| overwrite | No | Allow replacing an existing file at the output path (default false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outputPath | Yes | Path of the file written. |