video-logo-add

Video Logo Add

Overview

Overlay a Logo / watermark image at the four corners of a video, supporting transparent-background PNG. Covers brand Logo overlay, video watermark addition, corner badge stamping, and copyright marking.position Only four-corner positioning is supported (top-left / top-right / bottom-left / bottom-right); free coordinates are not supported.

Not handled: free positioning, watermark removal, text-only watermarks, adding watermarks to images, video content replacement.

API Mapping

Scenario	API name
Video Logo / watermark overlay	video_logo_add

Dependencies

• meitu-cli: >=2.0.6
• Credentials：CONFIG AKSK → meitu tools update; EXEC AKSK → run command
• Environment variables：MEITU_OPENAPI_TOOL_TASK_MODE=command

Path alias: $VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver

Preflight

1. meitu --version and meitu auth verify --json
2. Detect MEITU_OPENAPI_TOOL_TASK_MODE=command
3. output_dir: project → ./output/; one-off → $VISUAL/output/video-logo-add/；mkdir -p

Execute

Trigger signals and routing

User's exact words	Route
Add watermark / add Logo / stamp Logo / label / add corner badge / overlay Logo	video_logo_add

Single API tool: call when parameters are complete; after a failure, retry once and then return an error.

Parameter definitions

Parameter	Type	Required	Range	Default	Description
video_url	STRING	Yes	—	—	Original video URL
logo_url	STRING	Yes	—	—	Logo / watermark image URL; transparent-background PNG recommended
position	STRING	No	top-left / top-right / bottom-left / bottom-right	top-right	Overlay position (four corners only)

Tool invocation

meitu video-logo-add \
  --skill_name skill_video-logo-add \
  --video_url {url} \
  --logo_url {logo} \
  [--position top-right] \
  --json --download-dir {output_dir}

Error fallback

Scenario	Handling
video_url missing	Prompt "Please provide the video to which you want to add a Logo"
logo_url missing	Prompt "Please send the watermark image you want to add"
video_url inaccessible	Do not retry; prompt "Please provide a valid video link"
logo_url inaccessible	Do not retry; prompt "Please provide a valid Logo image link"
User says "add a text watermark" with no image	Inform them that the Logo must be in image form and suggest first creating the text as a PNG
User specifies a non-four-corner position such as "center"	Inform them that only four-corner positioning is supported
API call failure	Retry once; if it still fails, return an error
Content compliance interception	Return the compliance prompt directly; do not retry
Input is an image	Reject; only process videos

Deliver

mv {file} {output_dir}/{date}_{name}_logo-add.mp4

Output

• Format：MP4
• Naming：{YYYY-MM-DD}_{descriptive-name}_logo-add.mp4
• Location: project → ./output/; one-off → $VISUAL/output/video-logo-add/

Baseline Task ID

t_mt1a3i5n7b5ab3eb03-6bd9-46a1-a939-f1729fb73f56