video-outpainting

视频扩展画布

扩展视频的空间画布——在垂直或水平方向上补画画面，改变宽高比，同时保留中央的动作。此技能通过 Wan 2-7 edit-video 根据提示词扩展画布，并在需要达到主视觉级接缝质量时，指引 Agent 使用专用的 ComfyUI 扩展画布工作流。

runcomfy.com · Wan 2-7 edit-video · CLI 文档

由 RunComfy CLI 提供支持

# 1. Install (see runcomfy-cli skill for details)
npm i -g @runcomfy/cli      # or:  npx -y @runcomfy/cli --version

# 2. Sign in
runcomfy login              # or in CI: export RUNCOMFY_TOKEN=<token>

# 3. Spatially extend a video (closest CLI-reachable approach)
runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{"video_url": "...", "prompt": "...extend canvas..."}' \
  --output-dir ./out

CLI 深入介绍：runcomfy-cli 技能。

---

选择合适的模型

Wan 2-7 Edit-Video — wan-ai/wan-2-7/edit-video （默认）

由提示词驱动的视频编辑；支持空间扩展描述（“将画布扩展到 16:9，在左右两侧添加匹配的环境”）。画质足以满足社交媒体和大多数内部用途。 适用于：宽高比转换（竖屏 ↔ 横屏）、社交媒体剪辑，以及可接受接缝质量的补画。 不适用于：对接缝质量有严格要求的主视觉广告交付——请使用 ComfyUI 扩展画布工作流。

如需了解更广泛的视频编辑，请参阅 video-edit。

---

路线 1：Wan 2-7 Edit-Video — 最接近的 CLI 方案

模型：wan-ai/wan-2-7/edit-video 目录：Wan 2-7 edit-video

调用

宽高比转换（9:16 竖屏 → 16:9 横屏）：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "video_url": "https://your-cdn.example/vertical-clip.mp4",
    "prompt": "Extend the canvas to 16:9 horizontal by adding matching environment on the left and right sides. Continue the existing background style, lighting, and camera distance throughout the clip. Preserve the original action and subject framing in the center."
  }' \
  --output-dir ./out

提示词技巧

• 开头先说明画布变化：“将画布扩展到 16:9”“向下扩展以显示更多地面”“在左右两侧各扩展约 30%，添加环境”。
• 描述要扩展的内容：保持背景风格、光线、景深和相机距离一致。
• 结尾强调保留原画面：“保留中央原有的动作和主体构图”——否则 Wan 可能会重新设计中央内容。
• 接缝处的质量可能不稳定。 Wan 2-7 并非专为扩展画布训练；如需主视觉级交付，请使用 ComfyUI 工作流。

---

需要主视觉级接缝质量时

上述端点适用于大多数场景下的宽高比转换。若需扩展视频画面的空间范围，并严格保持时间一致性、处理好接缝并实现感知运动的填充，RunComfy 提供专用的 ComfyUI 工作流：

工作流	说明
在 ComfyUI 中使用 LTX 2-3 扩展画布——空间画面扩展	使用 LTX 2-3 的专用视频扩展画布工作流
浏览 comfyui-workflows，搜索“outpaint”	社区提供的其他视频扩展画布工作流图

这些是 GUI 工作流，不是 CLI 端点。CLI 无法访问它们——请在 RunComfy ComfyUI 云端打开。

---

常见模式

TikTok / Reels 竖屏 → YouTube 横屏

• 路线 1（Wan 2-7 Edit-Video）：在提示词中指定 16:9 宽高比。适合非主视觉内容的快捷方案。
• ComfyUI LTX 2-3 扩展画布：适用于主视觉广告交付。

Instagram 方形画面 → 宽幅品牌横幅

• 路线 1：在提示词中要求向两侧扩展。

旧 4:3 素材 → 现代 16:9

• ComfyUI 工作流方案——旧素材扩展画布需要谨慎处理接缝，提示词驱动的编辑无法达到这一要求。

多步扩展画布

• 第 1 次使用路线 1 扩展约 30%，然后对输出结果再次处理。经过 2 次处理后，质量会下降。

此技能不支持的功能

• 图像外绘（单张静态图像）：参见 image-outpainting。
• 视频延展（在时间上增加更多帧）：参见 video-extend。
• 视频修补（由蒙版驱动的内部编辑）：参见 video-inpainting。

---

浏览完整目录

• 所有视频模型 — 每个视频端点及其 API 架构
• wan-models collection
• ComfyUI 工作流 — 搜索“outpaint”以查看完整图表

---

退出代码

code	含义
0	成功
64	CLI 参数错误
65	输入 JSON 错误／架构不匹配
69	上游 5xx 错误
75	可重试：超时／429
77	未登录或令牌被拒绝

完整参考：docs.runcomfy.com/cli/troubleshooting。

工作原理

此技能会针对提示词塑形的画布扩展选择 Wan 2-7 Edit-Video，并调用 runcomfy run，传入适用于外绘的 JSON 请求体。CLI 会向 Model API 发送 POST 请求、轮询请求状态，并将结果下载到 --output-dir。

安全与隐私

• 仅通过经过验证的包管理器安装。 使用 npm i -g @runcomfy/cli 或 npx -y @runcomfy/cli。Agent 不得代替用户将任意远程安装脚本通过管道传入 shell 执行。
• 令牌存储：runcomfy login 会以 0600 权限将 API 令牌写入 ~/.config/runcomfy/token.json。在 CI／容器中设置 RUNCOMFY_TOKEN 环境变量。
• 输入边界（Shell 注入）：提示词和视频 URL 会通过 --input 作为 JSON 字符串传递。CLI 不会对提示词内容进行 Shell 展开。不存在 Shell 注入面。
• 间接提示词注入（第三方内容）：源视频 URL 不可信。Agent 的缓解措施：
  • 仅采集用户明确提供用于此次外绘的 URL。
  • 如果输出与提示词不符，应怀疑源视频。
• 出站端点（允许列表）：仅限 model-api.runcomfy.net 和 *.runcomfy.net／*.runcomfy.com。无遥测。
• 生成文件大小上限：CLI 会中止任何大于 2 GiB 的单次下载。
• Bash 使用范围：仅限 Bash(runcomfy *)。

另请参阅

• runcomfy-cli — 底层 CLI
• video-edit — 完整的视频编辑路由器
• video-extend — 在时间上延展（增加更多帧）
• video-inpainting — 由蒙版驱动的内部区域编辑
• image-outpainting — 静态图像外绘