video-edit

视频编辑 — RunComfy Pro 套件

runcomfy.com · Wan 2.7 Edit-Video · Kling Motion-Control Pro · Lucy Edit Restyle · GitHub

按意图路由的视频编辑。 此技能不会将你限制在单一模型上，而是根据用户的实际需求，从 RunComfy 目录中挑选合适的视频编辑模型：通用风格转换、从参考片段迁移动作，或轻量且能稳定保持身份特征的服装／背景替换。

npx skills add agentspace-so/runcomfy-skills --skill video-edit -g

根据用户意图选择合适的模型

用户意图	模型	原因
转换对话人物视频的风格 — 保留面部／姿势／嘴部动作	Wan 2.7 Edit-Video	强力保留身份特征和动作；支持最高 1080p
替换产品背景，保留镜头运动	Wan 2.7 Edit-Video	保留镜头运动；遵循单一方向的编辑
使用参考图替换包装设计	Wan 2.7 Edit-Video + reference_image	基于参考图进行设计迁移
应用电影级调色／商业质感润色	Wan 2.7 Edit-Video	擅长单一方向的整体外观变化
将参考视频中的精确动作迁移到目标角色	Kling 2.6 Pro Motion Control	专为动作映射和身份保持而设计
让目标角色的嘴部动作与源视频的嘴部动作同步	Kling 2.6 Pro Motion Control	专为严格的时间连贯性打造
在保留身份特征的同时进行轻量服装／戏服替换	Lucy Edit Restyle	核心优势是局部编辑且稳定保持身份特征
稳定保持身份特征的风格转换（“沙漠中的宇航员”“温暖的黄金时刻光线”）	Lucy Edit Restyle	专注于风格转换的时间一致性
未指定时的默认选择	Wan 2.7 Edit-Video	用途最广、分辨率最高

Agent 会读取此表，对用户意图进行分类，并选择下方对应的小节。

前置条件

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

---

路线 1：Wan 2.7 Edit-Video — 风格转换／背景／包装的默认选择

模型：wan-ai/wan-2-7/edit-video

架构

字段	类型	必填	默认值	备注
prompt	string	是	—	首先说明需要保留的内容。每次调用只指定一个编辑方向。
video	string	是	—	MP4/MOV URL，2–10s，≤100MB。
reference_image	string	否	—	URL — 仅用于直接迁移设计／外观。
resolution	enum	否	(input)	720p 或 1080p。
aspect_ratio	enum	否	(input)	宽:高。默认为输入值。
duration	int	否	0	0 = 匹配输入；2–10 = 从开头截取。
audio_setting	enum	否	auto	auto 或 origin（保留源音频）。
seed	int	否	—	用于确保可复现性。

调用

替换背景、保留身份特征并保留音频：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "prompt": "Preserve the speaker'\''s face, pose, and lip movement; change the background to a modern office with neutral lighting.",
    "video": "https://.../speaker.mp4",
    "audio_setting": "origin"
  }' \
  --output-dir <absolute/path>

使用参考图替换包装：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "prompt": "Maintain the original framing and hand movement; replace the packaging design using the reference image.",
    "video": "https://.../hand-holding-package.mp4",
    "reference_image": "https://.../new-packaging.png",
    "audio_setting": "origin"
  }' \
  --output-dir <absolute/path>

提示词技巧

• 先说明保留目标："保留 [面部 / 姿势 / 动作 / 构图 / 唇部动作]；[然后说明要进行的更改]"。
• 每次调用只指定一个编辑方向。 复合编辑容易导致动作偏移。
• 仅在有充分理由时使用 reference_image（更换包装、使用目标视觉效果更换服装）。一般风格重塑不要传入参考图。
• 对于不希望重新生成配乐的对话头像视频，使用 audio_setting: "origin"。
• 源视频限制：2–10s，≤100MB。

---

路由 2：Kling 2.6 Pro Motion Control — 适用于重点是参考片段中的动作

模型：kling/kling-2-6/motion-control-pro

当用户希望将参考视频中的动作迁移到目标角色上时使用（由图像或另一段视频驱动）。这不是风格重塑，而是在保留身份的同时映射动作。

Schema

字段	类型	必填	说明
prompt	string	是	描述目标动作 / 风格。
image	string	是（图像方向）	用于保持角色 / 背景一致性的参考图。
video	string	是	动作参考。时长为 10–30s，具体取决于方向。
keep_original_sound	bool	否	保留参考视频中的音频。
character_orientation	enum	是	image（输出最长 10s）或 video（输出最长 30s）。

调用

runcomfy run kling/kling-2-6/motion-control-pro \
  --input '{
    "prompt": "A young american woman dancing",
    "image": "https://.../target-character.jpg",
    "video": "https://.../motion-reference-dance.mp4",
    "character_orientation": "image",
    "keep_original_sound": true
  }' \
  --output-dir <absolute/path>

提示词技巧

• 为确保身份保持稳定，图像参考中的主体必须占画面 > 5%。
• 空间约束会有所帮助："角色位于左侧，背景向右移动"。
• 如果不同迭代的结果出现偏移，请简化提示词——删去形容词，保留核心动作描述。
• character_orientation: "image" 会将输出限制为 10s；"video" 则允许输出 30s。

---

路由 3：Lucy Edit Restyle — 轻量级、身份稳定的风格重塑 / 服装更换

模型：decart/lucy-edit/restyle

当编辑属于局部风格修改（更换服装、调整场景光照、重塑氛围风格），且保持身份至关重要时使用。它比 Wan 2.7 Edit 更轻量，分辨率上限为 720p。

Schema

字段	类型	必填	默认值	说明
prompt	string	是	—	自然语言编辑指令。
video_url	string	是	—	MP4/MOV/WEBM/GIF。
resolution	enum	否	720p	此级别仅支持 720p。

调用

更换服装：

runcomfy run decart/lucy-edit/restyle \
  --input '{
    "prompt": "Change outfit to professional business attire; preserve face and motion.",
    "video_url": "https://.../subject-walking.mp4"
  }' \
  --output-dir <absolute/path>

重塑氛围风格：

runcomfy run decart/lucy-edit/restyle \
  --input '{
    "prompt": "Make lighting warm and golden hour; preserve face, pose, and motion.",
    "video_url": "https://.../subject-portrait.mp4"
  }' \
  --output-dir <absolute/path>

提示词技巧

• 明确局部更改效果最好。 “服装”、“光照”、“背景”——选择一个类别。
• 说明保留身份的目标——"保留面部和动作" 就足够了；不要过度指定。
• 避免完全替换（“太空中的宇航员”可行；“将主体换成另一个人”则不行）。Lucy 专为局部风格修改打造，不适用于完整角色替换。
• 无法控制宽高比——输出与输入一致。如果不提前匹配，裁剪将在服务端进行。

---

限制

• 每条路由都受其模型自身限制。 Wan 2.7 Edit：2–10s，分辨率上限为 1080p。Kling：10s（图像方向）或 30s（视频方向）。Lucy：分辨率上限为 720p，无法控制宽高比。
• 不支持多路由混合。 此技能每次调用只选择一个模型。
• 品牌特定覆盖——如果用户指定了具体模型，请路由到相应的品牌技能（wan-2-7），以获取更完整的处理。

退出代码

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

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

工作原理

该技能会根据用户意图，从 Wan 2.7 Edit-Video / Kling 2.6 Pro Motion Control / Lucy Edit Restyle 中选择一个，并使用匹配的 JSON 请求体调用 runcomfy run <model_id>。CLI 会向 Model API 发送 POST 请求、轮询请求状态、获取结果，并将任何 .runcomfy.net/.runcomfy.com URL 下载到 --output-dir。按下 Ctrl-C 会在退出前取消远程请求。

安全与隐私

• 令牌存储：runcomfy login 会将 API 令牌写入 ~/.config/runcomfy/token.json，文件权限为 0600（仅所有者可读写）。在 CI / 容器中设置 RUNCOMFY_TOKEN 环境变量即可完全绕过该文件。
• 输入边界：用户提示词会通过 --input 以 JSON 字符串的形式传递给 CLI。CLI 不会对提示词进行 shell 展开，而是通过 HTTPS 将 JSON 请求体直接发送给 Model API。提示词内容不存在 shell 注入攻击面。
• 第三方内容：你传入的图像 / 蒙版 / 视频 URL 由 RunComfy 模型服务获取，而非由你本机上的 CLI 获取。请将外部 URL 视为不可信内容；基于图像的提示词注入是任何图像编辑 / 视频编辑模型都已知的风险。
• 出站端点：仅包括 model-api.runcomfy.net（提交请求）和 *.runcomfy.net / *.runcomfy.com（生成结果的下载白名单）。无遥测、无回调。
• 生成文件大小上限：为防止恶意模型输出或失控的模型输出占满磁盘，CLI 会中止任何超过 2 GiB 的单个下载。