Add Text to Draft
capcut_add_textOverlay styled text on videos with customizable fonts, colors, shadows, and animations for titles and subtitles.
Instructions
Add styled text overlay to video with positioning, colors, shadows, and animations.
This tool creates text elements with full styling control including fonts, colors, backgrounds, shadows, and animations.
Args:
draft_id (string): The draft ID
text (string): Text content to display (1-500 characters)
start (number): Start time in seconds
end (number): End time in seconds
font (string): Font family name (optional)
font_size (number): Font size 12-200 (default: 48)
font_color (string): Hex color e.g., #FFFFFF (default: #FFFFFF)
background_color (string): Background hex color (optional)
background_alpha (number): Background opacity 0.0-1.0 (default: 0.8)
shadow_enabled (boolean): Enable shadow (default: false)
shadow_color (string): Shadow hex color (default: #000000)
position_x (number): Horizontal position 0.0-1.0 (default: 0.5 center)
position_y (number): Vertical position 0.0-1.0 (default: 0.5 center)
animation (string): Animation effect (fade_in, slide_up, slide_down, slide_left, slide_right, zoom_in, bounce)
response_format ('markdown' | 'json'): Output format
Examples:
Add title: text="Welcome", font_size=72, position_y=0.2, animation="fade_in"
Add subtitle: text="Subscribe!", font_size=36, background_color="#000000"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | The ID of the draft to add text to | |
| text | Yes | The text content to display | |
| start | Yes | Start time in seconds | |
| end | Yes | End time in seconds | |
| font | No | Font family name | |
| font_size | No | Font size in points | |
| font_color | No | Font color in hex format | #FFFFFF |
| background_color | No | Background color in hex format | |
| background_alpha | No | Background opacity (0.0 to 1.0) | |
| shadow_enabled | No | Enable text shadow | |
| shadow_color | No | Shadow color in hex format | #000000 |
| position_x | No | Horizontal position (0.0 to 1.0, where 0.5 is center) | |
| position_y | No | Vertical position (0.0 to 1.0, where 0.5 is center) | |
| animation | No | Animation effect to apply | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |