overlay_image
Add images to videos with precise timing, positioning, and transparency control for creating watermarks, logos, or annotations.
Instructions
Overlay an image on top of a video with timing control.
Args: input_video_path (str): Path to background video. overlay_image_path (str): Path to image file. output_filename (str): Output video filename (saved inside VIDEO_OVERLAY_PATH). positioning (Literal): Where to place overlay. scale (tuple | None): (width, height) to resize image before placing. keep_audio (bool): Whether to keep background audio. opacity (float | None): Transparency level (0–1). None = no alpha applied. start_time (float): When to start showing overlay (seconds). duration (float | None): How long to show overlay (seconds). None = until end of video.
Returns: str: Path to generated video.
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_video_path": "<input_video_path>",
"overlay_image_path": "<overlay_image_path>"
},
"name": "overlay_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input_video_path | Yes | ||
| overlay_image_path | Yes | ||
| output_filename | No | output.mp4 | |
| positioning | No | top_right | |
| scale | No | ||
| keep_audio | No | ||
| opacity | No | ||
| start_time | No | ||
| duration | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |