RunComfy 图像编辑专业套件

runcomfy.com · Nano Banana Edit · GPT Image 2 Edit · Flux Kontext · Z-Image Inpaint · GitHub

基于意图路由的图像编辑。该技能不会限制你使用单一模型——它会根据用户的实际需求，从RunComfy模型库中挑选合适的编辑模型：批量保留主体特征、多语言文字改写、单指令精准编辑或基于蒙版的区域替换。

bash

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

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

用户意图	模型	选择理由
批量编辑1-20张图片并保持一致性（SKU图库、A/B测试变体）	Nano Banana Edit	每次调用最多支持20张输入图片；可锁定宽高比/分辨率以保证系列一致性
替换背景，保留主体特征	Nano Banana Edit	在“保持X不变”的提示下，主体特征保留能力出色
使用空间语言进行局部物体移除/添加（“左侧物体”“右上角”）	Nano Banana Edit	可识别并遵循方向性空间范围
多语言/非拉丁语系图像内文字改写（日文假名、西里尔字母、阿拉伯语）	GPT Image 2 Edit	多语言排版能力业内领先
多参考图合成（主体来自图1，场景来自图2，调色来自图3）	GPT Image 2 Edit	可通过编号参考图正确传递线索
布局精准重定位（“将标题从右上角移至底部中央”）	GPT Image 2 Edit	可在布局层面遵循方向性语言指令
翻译标题变体时保留主体特征	GPT Image 2 Edit	同一源素材生成多语言变体，主体特征保持稳定
单指令精准局部编辑（“她现在手持一把橙色雨伞”）	Flux Kontext Pro	单参考图单指令，高保真保留原有特征
基于蒙版的物体移除（线缆、水印、干扰元素）	Z-Image Turbo Inpaint	需配合蒙版使用，强度可调，边缘过渡自然
基于蒙版的区域替换（通过蒙版完全替换背景）	Z-Image Turbo Inpaint	高强度蒙版可实现干净的替换效果
用户未指定时的默认选择	Nano Banana Edit	灵活性最高，支持单张和批量编辑

智能代理会读取此表格，对用户意图进行分类，并选择对应的操作路径。

前置条件

RunComfy CLI —
```
npm i -g @runcomfy/cli
```
RunComfy账户 —
```
runcomfy login
```
CI/容器环境 — 设置环境变量
```
RUNCOMFY_TOKEN=<token>
```

路径1：Nano Banana Edit — 通用编辑和批量编辑默认选择

模型：

google/nano-banana-2/edit

参数 schema

字段	类型	是否必填	默认值	说明
`prompt`	字符串	是	—	先说明需要保留的内容，再描述修改需求
`image_urls`	数组	是	—	1-20个可公开访问的HTTPS图片链接
`number_of_images`	整数	否	1	每次调用可生成1-4张输出图片
`aspect_ratio`	枚举值	否	`auto`	`auto` 跟随输入图片；批量编辑时锁定可保证一致性
`resolution`	枚举值	否	`1K`	`0.5K` / `1K` / `2K` / `4K`
`output_format`	枚举值	否	`png`	`png` / `jpeg` / `webp`
`seed`	整数	否	—	用于生成结果可复现
`enable_web_search`	布尔值	否	false	基于网络搜索的编辑（会增加延迟）

调用示例

bash

runcomfy run google/nano-banana-2/edit \
  --input '{
    "prompt": "保留主体身份、姿势和服装不变。将背景改为雨夜霓虹赛博朋克街道。",
    "image_urls": ["https://.../portrait.jpg"]
  }' \
  --output-dir <absolute/path>

批量编辑（锁定宽高比和分辨率）：

bash

runcomfy run google/nano-banana-2/edit \
  --input '{
    "prompt": "将右下角的水印替换为干净的白色无衬线字体\"AURA\"。其他内容完全保持与输入一致。",
    "image_urls": ["https://.../sku-1.jpg", "https://.../sku-2.jpg", "https://.../sku-3.jpg"],
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }' \
  --output-dir <absolute/path>

提示技巧

先提保留需求：

"保持[身份/姿势/品牌/构图]不变。"

再说明修改内容

明确空间范围：“仅背景”“左侧物体”“右上象限”——具体位置指令会被遵循
批量一致性：批量编辑时锁定
```
aspect_ratio
```
和
```
resolution
```
分步修改：将复杂编辑拆分为多个简短步骤

路径2：GPT Image 2 Edit — 多语言文字+多参考图合成

模型：

openai/gpt-image-2/edit

参数 schema

字段	类型	是否必填	默认值	说明
`prompt`	字符串	是	—	编辑指令；先说明需要保留的内容
`images`	字符串数组	是	—	最多10个HTTPS链接。第一个是主图；其余为辅助参考图
`size`	枚举值	否	`auto`	`auto` , `1024_1024` , `1024_1536` , `1536_1024` 。仅支持这些选项

调用示例

多语言文字改写：

bash

runcomfy run openai/gpt-image-2/edit \
  --input '{
    "prompt": "完全保留照片、布局和品牌标识。仅替换图像内的标题。新标题为粗体日文假名\"今日のおすすめ\"，位置和字重与原标题一致。",
    "images": ["https://.../poster-en.jpg"]
  }' \
  --output-dir <absolute/path>

多参考图合成：

bash

runcomfy run openai/gpt-image-2/edit \
  --input '{
    "prompt": "将图1中的主体合成到图2的房间中。匹配图2的光线和调色板。保持图1主体身份不变。",
    "images": ["https://.../subject.jpg", "https://.../room.jpg"]
  }' \
  --output-dir <absolute/path>

提示技巧

准确引用图像内文字：非拉丁语系需注明文字类型：
```
"日文假名"
```
、
```
"西里尔字母"
```
、
```
"阿拉伯语从右到左"
```
给参考图编号：
```
"图1的主体，图2的光线"
```

使用方向性布局语言：

"将标题从右上角移至底部中央"

、

"替换右下角的水印"

推荐使用
size: "auto"
：保留输入图片的比例——除非编辑需要改变构图

路径3：Flux Kontext Pro — 单指令精准局部编辑

模型：

blackforestlabs/flux-1-kontext/pro/edit

极简参数 schema

字段	类型	是否必填	说明
`prompt`	字符串	是	一条陈述式编辑指令
`image`	字符串	是	单个源图片链接
`aspect_ratio`	枚举值	否	从支持的宽高比选项中选择
`seed`	整数	否	用于生成结果可复现

仅支持单张图片——不支持数组。多图片流程请使用路径1（Nano Banana Edit）。

调用示例

bash

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "保持人物的面部、姿势和服装不变。在她的左手添加一把橙色雨伞，并让她面带微笑。",
    "image": "https://.../portrait.jpg"
  }' \
  --output-dir <absolute/path>

提示技巧

使用单条陈述式指令：“她现在手持一把橙色雨伞并面带微笑”——简洁的祈使句，单一修改需求
先提保留需求：以
```
"保持[不变元素]"
```
开头，再说明修改内容
分步修改：单次复杂编辑容易出现偏差；拆分为多次连续操作

路径4：Z-Image Turbo Inpaint — 基于蒙版的精准区域编辑

模型：

tongyi-mai/z-image/turbo/inpainting

参数 schema

字段	类型	是否必填	说明
`prompt`	字符串	是	填充/替换内容；需说明蒙版外区域的保留约束
`image`	字符串	是	源图片链接
`mask_image`	字符串	是	灰度蒙版链接（白色=需要修复的区域，黑色=需要保留的区域）
`strength`	浮点数	否	0.3–0.6用于润色，0.7–1.0用于完全替换
`control_scale`	浮点数	否	通常设置为0.6–0.9
`aspect_ratio`	枚举值	否	输出图片的宽高比
`seed`	整数	否	用于生成结果可复现

调用示例

物体移除（低强度）：

bash

runcomfy run tongyi-mai/z-image/turbo/inpainting \
  --input '{
    "prompt": "移除架空线缆；保留屋顶轮廓和天空渐变；生成干净的浅色天空。",
    "image": "https://.../street.jpg",
    "mask_image": "https://.../cables-mask.png",
    "strength": 0.5,
    "control_scale": 0.8
  }' \
  --output-dir <absolute/path>

区域替换（高强度）：

bash

runcomfy run tongyi-mai/z-image/turbo/inpainting \
  --input '{
    "prompt": "将杂乱背景替换为光滑的浅灰色摄影棚背景纸；仅蒙版背景区域。",
    "image": "https://.../product.jpg",
    "mask_image": "https://.../bg-mask.png",
    "strength": 0.9
  }' \
  --output-dir <absolute/path>

提示技巧

必须提供蒙版链接——灰度图，白色=修复区域，黑色=保留区域。蒙版边缘轻微模糊（1-3像素）比尖锐的黑白边界融合效果更好
根据意图设置强度：
```
0.3–0.5
```
用于润色/清理，
```
0.6–0.7
```
用于风格匹配的物体替换，
```
0.8–1.0
```
用于全区域替换

在提示中明确蒙版外保留内容：

"保留屋顶轮廓和天空渐变"

、

"匹配砖块图案和砂浆色调"

即使有蒙版，空间标签仍有帮助：
```
"左侧架子"
```
、
```
"右上象限"
```

局限性

各路径继承对应模型的限制。Nano Banana：1-20张输入，1-4张输出。GPT Image 2 Edit：最多10个参考图，4种固定尺寸。Flux Kontext：仅支持单参考图。Z-Image Inpaint：必须使用蒙版。
不支持多路径混合。该技能每次调用仅选择一个模型。
品牌特定覆盖——如果用户指定了特定模型，请使用对应品牌的技能（
```
gpt-image-edit
```
、
```
flux-kontext
```
、
```
nano-banana-edit
```
）以获得更完整的功能。

退出码

代码	含义
0	成功
64	CLI参数错误
65	输入JSON错误/ schema不匹配
69	上游服务5xx错误
75	可重试：超时/429请求过多
77	未登录或令牌被拒绝

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

工作原理

该技能会根据用户意图从Nano Banana Edit / GPT Image 2 Edit / Flux Kontext Pro / Z-Image Turbo Inpaint中选择一个模型，并调用

runcomfy run <model_id>

命令及匹配的JSON参数。CLI会向Model API发送POST请求，轮询请求状态，获取结果，并将所有

.runcomfy.net

.runcomfy.com

链接的内容下载到

--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注入风险。
第三方内容：你传入的图片/蒙版/视频链接会由RunComfy模型服务器获取，而非本地CLI。请将外部链接视为不可信；图像提示注入是所有图像编辑/视频编辑模型的已知风险。
出站端点：仅允许访问
```
model-api.runcomfy.net
```
（请求提交）和
```
*.runcomfy.net
```
/
```
*.runcomfy.com
```
（生成结果下载白名单）。无遥测，无回调。
生成文件大小限制：CLI会中止任何超过2 GiB的单个文件下载，以防止恶意或异常模型输出占满磁盘。

image-edit

NPX安装

标签

SKILL.md 内容（中文）

RunComfy 图像编辑专业套件

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

前置条件

路径1：Nano Banana Edit — 通用编辑和批量编辑默认选择

参数 schema

调用示例

提示技巧

路径2：GPT Image 2 Edit — 多语言文字+多参考图合成

参数 schema

调用示例

提示技巧

路径3：Flux Kontext Pro — 单指令精准局部编辑

极简参数 schema

调用示例

提示技巧

路径4：Z-Image Turbo Inpaint — 基于蒙版的精准区域编辑

参数 schema

调用示例

提示技巧

局限性

退出码

工作原理

安全与隐私