mcpField
V
video-canvas-expand

video-canvas-expand

github.com/meitu创意与媒体36106 次安装9 周前更新
代码仓库

关于 video-canvas-expand

用于按指定方向扩展视频画布的技能，通过 AI 根据提示词补全新增区域。适合需要改变画面宽高而保持视频时长不变的场景；不负责裁剪或延长视频。

主要功能

  1. 01按左、右、上、下扩展画面
  2. 02每条边扩展原边长的 0 至 0.5 倍
  3. 03根据提示词生成扩展区域
  4. 04输出 MP4，保持原视频时长

适用场景

  1. 01为视频补出蓝天或街景
  2. 02向指定方向扩展视频画面
  3. 03同时扩展视频的多个边缘

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/video-canvas-expand确认已加载。

详细介绍

来自项目 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

评论

支持 Markdown