用途:这是 RunComfy 上的图像编辑技能,本身不绑定单一模型,而是根据用户意图在目录中挑选合适的编辑模型并调用。
主要能力与路由:批量一致编辑(1–20 张,如 SKU 图、A/B 变体)、换背景并保持主体身份、带空间语言的局部增删,走 Nano Banana Edit(模型 google/nano-banana-2/edit);多语言/非拉丁文字改写、多参考图合成、版面级重定位,走 GPT Image 2 Edit(openai/gpt-image-2/edit);单参考单指令的高保真局部编辑,走 Flux Kontext Pro(blackforestlabs/flux-1-kontext/pro/edit);需蒙版的物体移除与区域替换,走 Z-Image Turbo Inpaint(tongyi-mai/z-image/turbo/inpainting)。未指定时默认 Nano Banana Edit。
使用方式:先安装 CLI 并登录:npm i -g @runcomfy/cli、runcomfy login;CI/容器中可设 RUNCOMFY_TOKEN=<token>。技能安装命令为 npx skills add agentspace-so/runcomfy-skills --skill image-edit -g。调用形式为 runcomfy run <model_id> --input '<JSON>' --output-dir <绝对路径>,CLI 提交请求、轮询并下载结果。
限制:各路由继承对应模型限制——Nano Banana 支持 1–20 输入、1–4 输出;GPT Image 2 Edit 最多 10 个参考、仅 4 种固定尺寸;Flux Kontext 仅单参考;Z-Image Inpaint 必须提供灰度蒙版(白=重绘、黑=保留)。每次调用只选一个模型,不做多路由混合;若用户点名具体模型,应转到对应品牌技能。外部图片/蒙版 URL 由 RunComfy 服务器抓取,应视为不可信,注意图像提示注入风险。退出码:0 成功、64 参数错误、65 输入 JSON/模式不匹配、69 上游 5xx、75 可重试超时/429、77 未登录或令牌被拒。单文件下载超过 2 GiB 会被中止。