SuperAPI AI 工具集

video-edit

设计与创作

查看项目

更新于 10-15 08:33

技能介绍

Video Edit — Pro Pack on RunComfy 是一个面向视频编辑的智能路由技能,托管在 RunComfy 平台上。它的核心定位不是绑定某一个固定的视频编辑模型,而是充当“智能路由器”:根据用户的实际编辑意图,在 RunComfy 的模型目录中挑选最匹配的视频编辑模型,再用统一的命令行方式调用。

用途与模型选择

技能按用户意图将任务分为三类,并给出对应的匹配模型:

  1. 通用风格重塑、背景替换、包装设计替换、电影级调色或商业质感打磨,均路由到 Wan 2.7 Edit-Video。理由是该模型在身份与动作保持方面较强,支持到 1080p,能保留镜头运动并执行单向编辑。此模型也是未指定意图时的默认选项,因为适用范围最广、分辨率最高。

  2. 需要把参考视频中的精确动作迁移到目标角色、或让目标角色的口型与源视频口型对齐时,路由到 Kling 2.6 Pro Motion Control。它的设计目标是动作映射并保持身份一致,具备较强的时间连贯性。

  3. 轻量级的、身份稳定的换装或服装替换、场景重打光、氛围重塑,路由到 Lucy Edit Restyle。它的核心优势是局部化且身份稳定的编辑,专注重塑任务的时间一致性。

前置条件

需要 RunComfy CLI(npm i -g @runcomfy/cli)、一个 RunComfy 账号(通过 runcomfy login 登录),在 CI 或容器环境中可设置 RUNCOMFY_TOKEN=<token>。另需提供一个源视频 URL,其格式和限制取决于所选路线。

路线一:Wan 2.7 Edit-Video

模型 ID 为 wan-ai/wan-2-7/edit-video。输入字段包括:prompt(必填,字符串,建议先写保持目标,单次调用只做一个编辑方向);video(必填,MP4/MOV URL,2–10 秒,≤100MB);reference_image(可选,URL,仅用于直接的设计或外观迁移);resolution(可选,720p 或 1080p);aspect_ratio(可选,默认跟随输入);duration(可选,0 表示匹配输入,2–10 表示从起点截断);audio_setting(可选,auto 或 origin,origin 用于保留源音频);seed(可选,用于复现)。技能文档给出了背景替换(保持身份并保留音频)和使用参考图替换包装设计两个调用示例。提示建议:先写保持目标(如“保持面部/姿态/动作/构图/口型,然后说明改动”),单次调用只做一个编辑方向,因为复合编辑在动作上容易漂移;只有在包装替换、带目标视觉的换装等有正当理由时才传 reference_image;视频源限制为 2–10 秒、≤100MB。

路线二:Kling 2.6 Pro Motion Control

模型 ID 为 kling/kling-2-6/motion-control-pro。当重点是“把参考片段的动作迁移过来”时使用,它做的是带身份保持的动作映射,而不是风格重塑。字段包括:prompt(必填,描述目标动作/风格);image(在 image 方向下必填,作为角色/背景一致性的参考);video(必填,动作参考,时长随方向为 10–30 秒);keep_original_sound(可选,布尔值,保留参考视频音频);character_orientation(必填,image 时输出最长 10 秒,video 时输出最长 30 秒)。文档提示:图像参考中主体应占画面 5% 以上以保证身份保持清晰;可用空间约束描述(如“角色在左侧,背景运动在右侧”);若结果在多次迭代间漂移,可简化描述、去掉修饰词只留核心动作;character_orientation 为 image 时输出上限 10 秒,为 video 时允许 30 秒。

路线三:Lucy Edit Restyle

模型 ID 为 decart/lucy-edit/restyle。用于局部风格修改,如换装、场景重打光、氛围重塑,且身份保持至关重要。它比 Wan 2.7 Edit 更轻量,分辨率上限为 720p。字段包括:prompt(必填,自然语言编辑指令);video_url(必填,MP4/MOV/WEBM/GIF);resolution(可选,本档位仅支持 720p)。文档给出换装和暖色黄金时刻氛围重塑两个示例,并提示:局部化改动的措辞更有效,在“服装”“光照”“背景”中只选一个方向;保持身份的目标写“保持面部和动作”即可,不必过度指定;避免整体替换(“宇航员在太空”可行,但“把主体换成另一个人”不行),因为 Lucy 是为局部风格修改而非完整角色替换设计的;不支持宽高比控制,输出与输入一致,若未预先匹配会在服务端发生裁剪。

限制

每条路线各自继承其模型的限制:Wan 2.7 Edit 为 2–10 秒、上限 1080p;Kling 为 10 秒(image 方向)或 30 秒(video 方向);Lucy 上限 720p 且无宽高比控制。技能不支持多路线混合,每次调用只选择一个模型。若用户明确指定了某个模型,应转向对应的品牌技能(如 wan-2-7)获取更完整的处理。

退出码

0 表示成功;64 表示 CLI 参数错误;65 表示输入 JSON 错误或 schema 不匹配;69 表示上游 5xx;75 表示可重试(超时或 429);77 表示未登录或 token 被拒。完整参考见 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 会在退出前取消远程请求。

安全与隐私

Token 存储方面,runcomfy login 会把 API token 写入 ~/.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 的单次下载,以防恶意或失控的模型输出占满磁盘。