nano-banana-edit

Nano Banana Edit — RunComfy 专业版套件

runcomfy.com · 编辑端点 · GitHub

Google Nano Banana 2 Edit——Gemini 系列闪速图像模型的图生图编辑端点，由 RunComfy Model API 托管。每次调用最多可输入 20 张图像，用于批量编辑和多参考图变体生成。

npx skills add agentspace-so/runcomfy-skills --skill nano-banana-edit -g

何时选择此模型（与同系列模型比较）

你的需求	使用
保留主体身份，更换背景或服装	Nano Banana Edit
一次批量一致地编辑最多 20 张图像	Nano Banana Edit
使用空间描述将编辑限定为“仅 X”	Nano Banana Edit
编辑图像中的多语言文字（标志、标签）	GPT Image 2 edit
单张参考图 + 精确的局部编辑（“她现在拿着 X”）	Flux Kontext
从头生成新图像	Nano Banana 2 t2i（同系列技能）

如果用户明确说了“nano banana edit”或“用 nano banana 编辑”，无论如何都应路由到这里。

前置条件

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy 账户 — runcomfy login 会打开浏览器设备代码授权流程。
3. CI / 容器 — 设置 RUNCOMFY_TOKEN=<token>，代替 runcomfy login。

端点 + 输入架构

google/nano-banana-2/edit

字段	类型	必填	默认值	备注
prompt	string	是	—	编辑指令。先说明保留内容，最后说明改动。
image_urls	array	是	—	1–20 个可公开访问的 HTTPS URL。
number_of_images	int	否	1	每次调用生成 1–4 张输出图像。
seed	int	否	—	用于复现结果。
aspect_ratio	enum	否	auto	auto（沿用输入图像比例）或固定比例——批量处理时请锁定比例。
resolution	enum	否	1K	0.5K / 1K / 2K / 4K。
output_format	enum	否	png	png / jpeg / webp。
safety_tolerance	int	否	4	1（严格）– 6（宽松）。
limit_generations	bool	否	—	若为 true，则每轮限制为仅生成一个输出。
enable_web_search	bool	否	false	网络信息辅助（会增加成本 / 延迟）。

如何调用

单图更换背景并保留身份：

runcomfy run google/nano-banana-2/edit \
  --input '{
    "prompt": "Keep the subject identity, pose, and clothing unchanged. Convert the background into a rainy neon cyberpunk street.",
    "image_urls": ["https://.../portrait.jpg"]
  }' \
  --output-dir <absolute/path>

锁定构图的批量编辑：

runcomfy run google/nano-banana-2/edit \
  --input '{
    "prompt": "Replace the watermark in the bottom-right with the text \"AURA\" in clean white sans-serif. Keep everything else exactly as in the input.",
    "image_urls": ["https://.../sku-1.jpg", "https://.../sku-2.jpg", "https://.../sku-3.jpg"],
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }' \
  --output-dir <absolute/path>

定向空间编辑（“仅左侧物体”）：

runcomfy run google/nano-banana-2/edit \
  --input '{
    "prompt": "Remove the leftmost object only. Keep the right two objects, the table, and the lighting unchanged.",
    "image_urls": ["https://.../still-life.jpg"]
  }' \
  --output-dir <absolute/path>

提示词编写——哪些方法确实有效

先说明保留内容，最后说明改动。 始终以 "Keep [identity / pose / clothing / brand / framing] unchanged." 开头。然后用一句清晰的话说明改动。模型会遵循开头明确提出的要求；末尾才提到的保留要求往往会被忽略。

使用空间描述限定范围。 “仅背景”、“左侧物体”、“右上角”、“标题上方”等具体的空间范围更容易得到遵循。“让它更 X”则过于模糊，容易产生偏差。

批量一致性——编辑一组图像时，锁定 aspect_ratio 和 resolution。整个批次使用相同的提示词句式，让每个输出看起来像同系列作品，而非重新混编。

小步迭代。 如果单次编辑出现偏差，可拆分为两步：第 1 步只改背景，第 2 步更换主体服装。这样编辑更干净，总成本不变（假设分辨率相近）。

多图变体——最多传入 20 张输入图像，以获得风格统一的一批结果。适用于 SKU 产品图库、A/B 测试、角色设定变体。

反面模式：

• 冗长的复合指令（“更改 A、B、C 和 D”）——范围每增加一项，偏差就会增大。
• 使用被动语态编写编辑指令（“应更改背景”）——请使用祈使句。
• 未说明需要保留的内容——模型可能会悄悄改写面部 / 品牌。
• 宽高比与输入图像不匹配——会导致裁切或拉伸。

适用场景

使用场景	Nano Banana Edit 的优势
SKU 图库 — 同一产品使用不同背景	批量生成 20 张，保留产品身份，锁定构图
网红 / 代言人背景替换	编辑时能很好地保留人物身份
局部移除 / 添加物体	能准确遵循空间描述
广告创意 A/B 变体	锁定种子 + 多个 number_of_images
品牌素材本地化	保持相同构图，只替换文字 / 配色

示例提示词（经验证，效果出色）

替换背景（页面示例）：

Keep the subject identity unchanged. Convert the background into a rainy
neon cyberpunk street.

替换指定文本：

Keep the bottle, label, and lighting exactly as in the input.
Replace only the brand text on the label from "ALPHA" to "AURA",
same font weight, centered, white on black.

多图批次一致性：

For each input image: keep the subject's pose and identity unchanged.
Convert the background to a soft warm-grey studio sweep with subtle
floor shadow. Center the subject at the same fraction of frame as the
input.

限制

• 每次调用输入 1–20 张图片 — 第一张视为主图，其余图片提供辅助线索。
• 每次调用输出 1–4 张图片。
• 冗长的复合提示词容易产生偏差 — 请拆分为多轮处理。
• 网页搜索会增加延迟和成本 — 仅在需要时启用。
• 编辑图片中的多语言文本时，GPT Image 2 edit 的效果更好。

退出代码

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

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

工作原理

该技能会调用 runcomfy run google/nano-banana-2/edit，并传入符合架构的 JSON 请求体。CLI 会向 https://model-api.runcomfy.net/v1/models/google/nano-banana-2/edit 发送 POST 请求、轮询请求状态、获取结果，并将任何 .runcomfy.net/.runcomfy.com URL 下载到 --output-dir。Ctrl-C 会在退出前取消远程请求。

安全与隐私

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