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.
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 |