mcpField
V
video-canvas-expand

video-canvas-expand

github.com/meituCreative & media36106 installsUpdated 9w ago
Repository

About video-canvas-expand

A skill for expanding a video's canvas in selected directions, using a prompt to fill the added areas. It changes the frame dimensions without extending the video's duration and does not perform cropping.

Key features

  1. 01Expand left, right, up, or down
  2. 02Extend each edge by 0 to 0.5 of its original length
  3. 03Generate added areas from a prompt
  4. 04Output MP4 while preserving video duration

Use cases

  1. 01Add sky or street scenery around a video
  2. 02Expand a video frame in selected directions
  3. 03Extend multiple edges of a video at once

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/meitu/meitu-skills --skill video-canvas-expand

After installing, type/video-canvas-expandin Claude Code to confirm it loaded.

Details

From the project README

Video Canvas Expand

Overview

将视频画面按方向向外 outpainting 扩展，AI 根据 prompt 智能补全扩展区域。支持左/右/上/下任意组合方向，每条边扩展 0~0.5 倍原边长。时长不变，仅画面变宽/变高。

不处理：视频内容编辑（替换画面内容）、视频时长延长、视频裁剪/缩小、图片扩展。

API Mapping

场景API nameworkflow
视频画布扩展（outpainting）video_canvas_expandaigc_vace_outpainting_flow

Dependencies

  • meitu-cli: >=2.0.6
  • 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 跑命令
  • 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名： $VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver
Preflight
  1. meitu --version 与 meitu auth verify --json
  2. 检测 MEITU_OPENAPI_TOOL_TASK_MODE=command
  3. output_dir：项目 → ./output/；一次性 → $VISUAL/output/video-canvas-expand/；mkdir -p
Execute

触发信号与路由

用户原话路由
扩展视频 / 视频扩图 / outpainting / 往某方向扩 / 补画面video_canvas_expand

决策顺序：

  1. video_url 缺失 → 追问；prompt 缺失 → 追问"扩展区域补什么"
  2. directions 不传默认四方向全扩；expand_ratio 不传默认 0.3
  3. 唯一路由：调用 video_canvas_expand

参数定义

参数类型必填范围默认说明
video_urlSTRING是——原视频 URL
promptSTRING是——扩展区域补什么（如"补蓝天"、"扩展街景"）
expand_ratioSTRING否0 ~ 0.5"0.3"每条边扩展比例
directionsSTRING否left/right/up/down 组合（逗号分隔）"left,right,up,down"扩展方向

工具调用

meitu video-canvas-expand \
  --skill_name skill_video-canvas-expand \
  --video_url {url} \
  --prompt "{扩展内容描述}" \
  [--expand_ratio 0.3] \
  [--directions "left,right,up,down"] \
  --json --download-dir {output_dir}

错误降级

场景处理
video_url 缺失提示"请提供需要扩展的视频"
video_url 不可访问不重试，提示"请提供有效视频链接"
prompt 缺失提示"请描述扩展区域想补全的内容（如'补蓝天'）"
expand_ratio 越界（<0 或 >0.5）截断至 [0, 0.5] 或提示调整
directions 非法值回退至默认四方向
API 调用失败 / 超时重试 1 次，仍失败返回错误
内容合规拦截直接返回合规提示，不重试
用户说"改成 16:9"但意图是裁剪本工具仅扩展不裁剪，告知差异
输入为图片拒绝，仅支持视频
Deliver

mv {file} {output_dir}/{date}_{name}_canvas-expand.mp4

Output

  • 格式：MP4
  • 命名：{YYYY-MM-DD}_{descriptive-name}_canvas-expand.mp4
  • 位置：项目 → ./output/；一次性 → $VISUAL/output/video-canvas-expand/

基线 Task ID

t_mt1a3i5n7b66e66f5e-5e15-40b7-bf78-412a9490540b

Comments

Markdown supported