Add Image to Draft
capcut_add_imageAdd image overlays to videos with configurable position, scale, rotation, and animation effects.
Instructions
Add image overlay to video with positioning, scaling, rotation, and animation.
This tool adds static or animated images to the video timeline.
Args:
draft_id (string): The draft ID
image_url (string): URL to image file (jpg, jpeg, png, gif, webp, bmp)
start (number): Start time in seconds
end (number): End time in seconds
position_x (number): Horizontal position 0.0-1.0 (default: 0.5)
position_y (number): Vertical position 0.0-1.0 (default: 0.5)
scale (number): Scale multiplier 0.1-5.0 (default: 1.0)
rotation (number): Rotation angle 0-360 degrees (default: 0)
animation (string): Animation effect (optional)
response_format ('markdown' | 'json'): Output format
Examples:
Add logo: image_url="https://...", position_x=0.9, position_y=0.1, scale=0.3
Add rotating image: rotation=45, animation="zoom_in"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | The ID of the draft to add image to | |
| image_url | Yes | URL to the media file | |
| start | Yes | Start time in seconds | |
| end | Yes | End time in seconds | |
| position_x | No | Horizontal position (0.0 to 1.0) | |
| position_y | No | Vertical position (0.0 to 1.0) | |
| scale | No | Scale multiplier | |
| rotation | No | Rotation angle in degrees | |
| animation | No | Animation effect to apply | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |