# Video Canvas Expand

> 使用 meitu-cli 做视频画布向外 outpainting 扩展，AI 根据 prompt 智能补全扩展区域。当用户提到扩展视频、视频扩图、画面往左右上下扩、视频 outpainting、给视频补画面、扩出更多背景、让视频画面更宽时触发。

- **Type:** Skill
- **Install:** `agentstack add skill-meitu-meitu-skills-video-canvas-expand`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [meitu](https://agentstack.voostack.com/s/meitu)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [meitu](https://github.com/meitu)
- **Source:** https://github.com/meitu/meitu-skills/tree/main/skills/video-canvas-expand

## Install

```sh
agentstack add skill-meitu-meitu-skills-video-canvas-expand
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Video Canvas Expand

## Overview

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

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

## API Mapping

| 场景 | API name | workflow |
|---|---|---|
| 视频画布扩展（outpainting） | `video_canvas_expand` | `aigc_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_url` | STRING | 是 | — | — | 原视频 URL |
| `prompt` | STRING | 是 | — | — | 扩展区域补什么（如"补蓝天"、"扩展街景"）|
| `expand_ratio` | STRING | 否 | 0 ~ 0.5 | `"0.3"` | 每条边扩展比例 |
| `directions` | STRING | 否 | left/right/up/down 组合（逗号分隔）| `"left,right,up,down"` | 扩展方向 |

**工具调用**

```bash
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.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`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [meitu](https://github.com/meitu)
- **Source:** [meitu/meitu-skills](https://github.com/meitu/meitu-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-meitu-meitu-skills-video-canvas-expand
- Seller: https://agentstack.voostack.com/s/meitu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.