需要保持主体身份换背景、批量一致编辑或按空间局部编辑图片时…

在 RunComfy 上通过 `runcomfy run google/nano-banana-2/edit` 对 1–20 张图片做身份保持、背景替换、局部空间编辑和批量一致编辑；适合 SKU 图集、发言人换背景、广告 A/B 和品牌资产本地化。

适用场景

解决思路

1. 调用端点 `google/nano-banana-2/edit`：执行 `runcomfy run google/nano-banana-2/edit --input '<JSON>' --output-dir <absolute/path>`。
2. 构造 `--input` JSON；必填 `prompt` 为编辑指令，先写保留目标，最后写要改变的内容。
3. 必填 `image_urls`：传入 1–20 个可公开获取的 HTTPS URL；第一张作为主图，其余提供辅助线索。
4. 可选 `number_of_images`：默认 1，范围 1–4，控制每次调用输出数量。
5. 可选 `seed`：用于复现相同结果。
6. 可选 `aspect_ratio`：默认 `auto` 跟随输入；批量编辑时锁定固定比例以保持一致。
7. 可选 `resolution`：默认 `1K`，可选 `0.5K` / `1K` / `2K` / `4K`。
8. 可选 `output_format`：默认 `png`，可选 `png` / `jpeg` / `webp`。
9. 可选 `safety_tolerance`：默认 4，范围 1（严格）到 6（宽松）。
10. 可选 `limit_generations`：若为 true，限制每轮只生成一个输出。
11. 可选 `enable_web_search`：默认 false；开启会做 Web grounding，增加成本与延迟，仅在需要时开启。
12. 单图背景替换示例：`--input '<JSON>'` 中 `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>`。
13. 批量编辑锁定构图示例：`--input '<JSON>'` 中 `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`。
14. 空间局部编辑示例：`--input '<JSON>'` 中 `prompt` 设为 `Remove the leftmost object only. Keep the right two objects, the table, and the lighting unchanged.`，`image_urls` 放 `https://.../still-life.jpg`。
15. 提示词保留优先、变化最后：开头写 `Keep [identity / pose / clothing / brand / framing] unchanged.`，然后一句干净句子说明变化；尾部保留常被忽略。
16. 用空间语言局部化：使用 `background only`、`the left object`、`the upper-right corner`、`above the headline` 等具体空间范围；避免 `make it more X` 这种模糊表述。
17. 批量一致性：编辑系列图时锁定 `aspect_ratio` 和 `resolution`，并在整个批次使用相同 prompt 语法，让每张输出像同一系列而不是混搭。
18. 小步迭代：如果一次编辑漂移，拆成两遍；第 1 遍只改背景，第 2 遍换主体服装；编辑更干净，总成本相近（分辨率相近时）。
19. 多图变体：一次传最多 20 张输入图，获得连贯批次；适用于 SKU 图集、A/B 测试、角色表变体。
20. 反模式：避免长复合指令，如 `change A and B and C and D`；每增加一个范围都会增加漂移。
21. 反模式：避免被动语态，如 `the background should be changed`；要用祈使句。
22. 反模式：不要漏写保留目标，否则模型会轻微重写脸或品牌。
23. 反模式：宽高比不要与输入不匹配，否则会导致裁切或拉伸。
24. 已验证 prompt：背景替换用 `Keep the subject identity unchanged. Convert the background into a rainy neon cyberpunk street.`。
25. 已验证 prompt：定向文字替换用 `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.`。
26. 已验证 prompt：多图批量一致性用 `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.`。
27. 限制：每次调用 1–20 张输入图，第一张为主图，其余为辅助线索。
28. 限制：每次调用 1–4 个输出。
29. 限制：长复合 prompt 会漂移，拆成多遍处理。
30. 限制：Web search 增加延迟与成本，仅在需要时开启。
31. 限制：多语言图内文字编辑改用 GPT Image 2 edit 更好。
32. 退出码：0 成功；64 错误 CLI 参数；65 输入 JSON 错误或 schema 不匹配；69 上游 5xx；75 可重试：超时或 429；77 未登录或 token 被拒。
33. 工作机制：CLI 将 JSON body POST 到 `https://model-api.runcomfy.net/v1/models/google/nano-banana-2/edit`，轮询请求，获取结果，并把任意 `.runcomfy.net` / `.runcomfy.com` URL 下载到 `--output-dir`；`Ctrl-C` 会在退出前取消远程请求。
34. 安全：`runcomfy login` 将 API token 写到 `~/.config/runcomfy/token.json`，权限 0600（仅所有者读写）；CI 或容器中用 `RUNCOMFY_TOKEN` 环境变量绕过文件。
35. 安全：用户 prompt 通过 `--input` 作为 JSON 字符串传给 CLI；CLI 不做 shell 展开，直接把 JSON body 经 HTTPS 传给 Model API，prompt 内容无 shell 注入面。
36. 安全：传入的 image、mask、video URL 由 RunComfy 模型服务器抓取，不是本机 CLI；把外部 URL 当不可信，图像 prompt injection 是任何图像或视频编辑模型的已知风险。
37. 安全：出站端点仅 `model-api.runcomfy.net`（提交请求）和 `*.runcomfy.net` / `*.runcomfy.com`（下载白名单）；无遥测、无回调。
38. 安全：CLI 会中止任何单次下载大于 2 GiB 的文件，防止恶意或失控模型输出填满磁盘。

适用边界 · 注意事项

• 图内多语言文字编辑（招牌、标签）不要用此模型，改用 GPT Image 2 edit。
• 单参考图且要求精确局部编辑（如她现在拿着 X）优先用 Flux Kontext。
• 需要从零生成新图时不要用此 edit 端点，改用 Nano Banana 2 t2i。