mcpField
V
video-canvas-expand

video-canvas-expand

github.com/meituクリエイティブ・メディア36106 回インストール9 週間前に更新
リポジトリ

video-canvas-expand について

プロンプトに基づいて追加領域を生成し、動画のキャンバスを指定方向へ広げるスキルです。動画の長さは変えずに画面サイズを変更し、クロップには対応しません。

主な機能

  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 対応