🫧 Video Edit — Pro Pack on RunComfy

[runcomfy.com](https://www.runcomfy.com/?utm_source=clawhub&utm_medium=skill&utm_campaign=video-edit-runcomfy) · [docs](https://docs.runcomfy.com/cli/introduction?utm_source=clawhub&utm_medium=skill&utm_campaign=video-edit-runcomfy) · [Video edit models](https://www.runcomfy.com/models?utm_source=clawhub&utm_medium=skill&utm_campaign=video-edit-runcomfy)

在 RunComfy 上进行视频编辑。 本技能是 RunComfy 模型 API 的标准视频编辑入口：提供源视频 URL 和编辑指令，即可返回编辑后的视频。在 RunComfy 上的视频编辑，是指对已有片段进行变换——如风格重制、背景替换、服装更换、动作迁移、色彩调校等，无需重新拍摄。

本场景中“视频编辑”的含义

视频编辑是指以源视频为基础，生成一个经过变换的视频，在你希望保留的部分（如人物身份、动作或构图）保持一致的同时，实现指定内容的改变。视频编辑不同于文本生成视频（无输入视频）和图像生成视频（输入为静态图像）。常见的视频编辑操作包括：

• 风格重制视频编辑 — 在保留主体和动作的前提下，改变画面风格、光照与氛围。
• 背景替换视频编辑 — 替换对话类或产品类视频的背景，同时保持前景人物身份不变。
• 服装更换视频编辑 — 更换人物服饰，但保持面部特征、姿态和动作稳定。
• 动作迁移视频编辑 — 将参考视频中的动作迁移到目标角色上。
• 色彩调校视频编辑 — 为现有视频添加电影级色彩、胶片颗粒或商业级美化效果。
• 包装更换视频编辑 — 使用参考图像替换产品包装设计，同时保留摄像机运动轨迹。

该技能会根据用户意图选择合适的视频编辑端点，并调用 runcomfy run <model>/<edit-endpoint> 命令，使用对应的参数结构。

何时使用 RunComfy 上的视频编辑

当满足以下任一条件时，请使用 RunComfy 视频编辑功能：

• 你已拥有一个现有视频，并希望对其进行修改——视频编辑正是合适任务。
• 你需要身份稳定的视频编辑——输入视频中的主体、品牌或产品必须在输出视频中得以保留。
• 你需要快速迭代视频编辑——RunComfy 提供 GPU 资源，无需自行部署或租赁。
• 你正在规模化生产视频编辑内容——如多语言视频配音、A/B 版本视频编辑、跨 SKU 的批量视频编辑任务。

如果用户提到“视频编辑”、“编辑视频”、“重制这个视频”、“更换背景”、“更换服装”、“迁移这段动作”、“为这个片段调色”，或展示视频并要求变换内容——请引导至本技能。

视频编辑路由

智能体将读取此表，识别用户意图，并选择匹配的端点。

前置条件

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy 账户 — runcomfy login
3. CI / 容器环境 — 设置 RUNCOMFY_TOKEN=<token>
4. 源视频 URL — 格式和大小限制取决于所选视频编辑路径

默认视频编辑 — Wan 2.7 Edit-Video

默认视频编辑端点。适用于各类通用视频编辑任务：重制对话类视频风格、更换产品背景、使用参考图像替换包装设计、为视频添加电影级色彩调校。支持最高 1080p 输出。

参数结构

调用示例

背景替换视频编辑，保留身份与音频：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "prompt": "保留说话者的面部、姿势和口型动作；将背景改为现代办公室，采用中性光线。",
    "video": "https://.../speaker.mp4",
    "audio_setting": "origin"
  }' \
  --output-dir <absolute/path>

使用参考图像进行包装更换视频编辑：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "prompt": "保持原有构图和手部动作；使用参考图像替换包装设计。",
    "video": "https://.../hand-holding-package.mp4",
    "reference_image": "https://.../new-packaging.png",
    "audio_setting": "origin"
  }' \
  --output-dir <absolute/path>

动作迁移视频编辑 — Kling 2.6 Pro Motion Control

当需要将参考视频中的动作迁移到目标角色上时使用。这并非风格重制，而是基于动作映射的视频编辑，强调身份保持。

Skill: 🫧 视频编辑 — 专业版（RunComfy）

版本: 0.1.2

分块: 2/3

runcomfy run kling/kling-2-6/motion-control-pro \
  --input '{
    "prompt": "一位年轻的美国女性跳舞",
    "image": "https://.../target-character.jpg",
    "video": "https://.../motion-reference-dance.mp4",
    "character_orientation": "image",
    "keep_original_sound": true
  }' \
  --output-dir <绝对路径>

轻量级视频编辑 — Lucy 编辑重风格化

适用于局部风格修改类任务，如换装、场景重打光、氛围重设计等，且对身份一致性要求极高。相比 Wan 2.7 视频编辑更快速、成本更低，最高分辨率限制为 720p。

换装视频编辑示例：

runcomfy run decart/lucy-edit/restyle \
  --input '{
    "prompt": "更换为职业商务装；保持面部和动作不变。",
    "video_url": "https://.../subject-walking.mp4"
  }' \
  --output-dir <绝对路径>

氛围风格化视频编辑示例：

runcomfy run decart/lucy-edit/restyle \
  --input '{
    "prompt": "使灯光转为温暖的黄金时刻效果；保持面部、姿态和动作不变。",
    "video_url": "https://.../subject-portrait.mp4"
  }' \
  --output-dir <绝对路径>

视频编辑提示技巧 — 有效表达方式

视频编辑提示与文本生成视频提示的行为不同。源视频已固定大部分视觉特征，因此你的提示应聚焦于“变化”，而非重复描述已有内容。

• 优先明确保留项。 使用格式："保留 [面部 / 姿态 / 动作 / 框架 / 嘴部动作]；[再说明需要修改的部分]"。明确告诉模型哪些部分不应改变。
• 每次调用只执行一个编辑方向。 复合编辑容易导致动作漂移。每次调用请专注一个类别——重风格化、背景替换、换装、色彩调整等。
• **仅在需要精确视觉匹配时使用 reference_image。** 如包装替换、服装与目标完全一致的情况。一般重风格化任务无需提供参考图。
• **对于口播类视频编辑，使用 audio_setting: "origin"。** 避免音轨被重新生成。
• 轻量级编辑推荐使用局部化描述。 如“服装”、“灯光”、“背景”——每次只选一个维度进行修改。

视频编辑常见问题

视频编辑最长支持多长时间？

Wan 2.7 视频编辑：2–10 秒。Kling 动作控制：10 秒（图像方向）或 30 秒（视频方向）。Lucy 重风格化：与输入视频时长一致。

支持哪些视频格式？

支持 MP4、MOV（Lucy 还支持 WEBM 和 GIF）。Wan 2.7 的输入视频大小不得超过 100MB。

视频编辑是否保留面部身份？

是的——三种视频编辑路径均以身份保真为核心设计。请明确写出：“保留面部和动作”。

能否保留原始音频？

可以——Wan 2.7 视频编辑中设置 audio_setting: "origin"，Kling 中设置 keep_original_sound: true。Lucy 默认保留音频。

当前最高分辨率是多少？

Wan 2.7 视频编辑支持 1080p。Kling 和 Lucy 最高均为 720p。

视频编辑与 RunComfy 上的文本生成视频有何区别？

视频编辑基于已有视频片段进行修改（外观主要由源视频决定）。文本生成视频从零开始生成画面（外观由提示词决定）。若已有视频素材，建议使用视频编辑；若需创造全新内容，则使用文本生成视频。

能否在一个调用中完成多个视频编辑？

不能。每个调用仅支持单一编辑方向。如需复合编辑，请分步调用并手动拼接结果。

限制说明

• 每种视频编辑路径继承其对应模型的限制。

Wan 2.7 视频编辑：2–10 秒，最高 1080p。

Kling 动作控制：按方向区分，10 秒或 30 秒。

Lucy 重风格化：720p，不支持自定义画幅比例。

• 不支持多路径视频编辑融合。 本技能每次调用仅选择一个视频编辑模型。若需同时实现换装 + 动作迁移，需两次调用并手动拼接。
• 品牌特定覆盖规则。 若用户指定了特定模型变体，应直接调用对应品牌技能（如 wan-2-7），而非通过此视频编辑路由强制转发。

退出码

完整参考：[docs.runcomfy.com/cli/troubleshooting](https://docs.runcomfy.com/cli/troubleshooting?utm_source=clawhub&utm_medium=skill&utm_campaign=video-edit-runcomfy)。

工作原理

该技能根据用户意图自动选择以下三个视频编辑接口之一（Wan 2.7 视频编辑、Kling 动作控制、Lucy 重风格化），并调用 runcomfy run <endpoint> 执行对应请求，传入匹配的 JSON 数据体。CLI 将请求发送至 RunComfy 模型 API，每 2 秒轮询一次任务状态，待完成后从 *.runcomfy.net 或 *.runcomfy.com 地址下载结果视频至 --output-dir 指定目录。按下 Ctrl-C 可取消正在进行的视频编辑任务。

安全与隐私

• Token 存储：runcomfy login 会将 API token 写入 ~/.config/runcomfy/token.json，文件权限为 0600。在 CI 环境中，请设置 RUNCOMFY_TOKEN 环境变量。
• 输入边界：视频编辑提示通过 --input 以 JSON 格式传入。CLI 不进行 shell 展开，无 shell 注入风险。
• 第三方内容：视频或图像的 URL 由 RunComfy 服务器获取。请将外部 URL 视为不可信内容——基于图像的提示注入是任何视频编辑模型已知的安全风险。
• 出站端点：仅允许访问 model-api.runcomfy.net 以及 *.runcomfy.net / *.runcomfy.com。不包含遥测请求。
• 生成文件大小限制：CLI 会终止任何大于 2 GiB 的视频编辑下载操作。