nano-banana-2

Nano Banana 2 — RunComfy Pro Pack

runcomfy.com · 模型页面 · GitHub

Google Nano Banana 2——Gemini 系列中的闪速级文生图模型，由 RunComfy Model API 托管。针对创意构思、社交媒体缩略图批量生成和快速草稿进行了优化，并具备出色的图中文字排版能力。

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

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

Nano Banana 2 是 Google 图像生成系列中的闪速级模型。需要快速迭代和可预测的构图，且对细节的极致追求并非首要时，选择它。

需求	使用
快速草稿、社交媒体缩略图、批量变体	Nano Banana 2
图中文字排版效果稳定	Nano Banana 2
基于网络信息生成图像（时事／真实实体）	Nano Banana 2 + enable_web_search
图像编辑（保留主体、更换背景）	Nano Banana Edit（同系列技能）
强烈风格化、绘画质感	Flux 2
最大程度遵循提示词 + 多语言文字	GPT Image 2
2K–4K 主视觉图、极致真实感	Seedream 5
超写实人像	Nano Banana Pro

如果用户明确提到“ Nano Banana”／“nano-banana-2”／“Gemini image”，无论如何都选择此技能。如果用户只说“ Nano Banana”，未指定 2 还是 Pro，人像默认选择 Pro，其他情况默认选择 2。

前置条件

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy 账户 — runcomfy login 会打开浏览器设备码登录流程。
3. CI／容器 — 设置 RUNCOMFY_TOKEN=<token>，而不是运行 runcomfy login。

端点 + 输入架构

google/nano-banana-2/text-to-image

字段	类型	必填	默认值	说明
prompt	string	是	—	主体优先的描述。
num_images	int	否	1	1–4。构思阶段可设为 4。
seed	int	否	0	重复使用以确保结果可复现。
aspect_ratio	enum	否	auto	auto、21:9、16:9、3:2、4:3、5:4、1:1、4:5、3:4、2:3、9:16。
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	添加网络信息参考（会增加费用和延迟）。

如需编辑图像（保留主体并应用更改），请参阅同系列的 nano-banana-edit 技能。

调用方式

默认草稿（1K、正方形、png）：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{"prompt": "<user prompt>"}' \
  --output-dir <absolute/path>

用于构思的纵向 4 张批次：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<user prompt>",
    "num_images": 4,
    "aspect_ratio": "9:16",
    "resolution": "0.5K"
  }' \
  --output-dir <absolute/path>

使用固定 seed 生成 2K 最终稿：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<user prompt>",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "seed": 42
  }' \
  --output-dir <absolute/path>

基于网络信息生成（时事／真实实体）：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<prompt referencing a real-world event from this week>",
    "enable_web_search": true
  }' \
  --output-dir <absolute/path>

提示词——哪些做法真正有效

主体优先的陈述式语法。 “一位美国女性站在雨中的东京霓虹灯下，电影感特写肖像，浅景深，湿润街道的倒影，超精细，逼真的皮肤质感”——先写主要主体，再写动作、环境、风格和镜头。把主体放在前面；指令放在后面。

精确引用图中文字。 “标签上写着 ‘AURA’，使用简洁粗体无衬线字体，居中，白底黑字”——将字面字符加上引号。指定位置和字体风格。不要只说“上面印着品牌名称”，然后寄希望于模型猜对。

使用一致的种子进行优化。 对单个提示词进行小幅变体迭代时，锁定 seed——这样可以保持构图稳定。

谨慎使用 Web 信息检索。 只有当提示词提及当前事件／真实实体时，才启用 enable_web_search。这会增加延迟和成本；默认关闭。

不要混用冲突的风格。 “极简主义 + 华丽装饰 + 复古 + 赛博朋克”会相互抵消。选择 1–2 个核心风格。

反模式：

• 试图用文字描述稳定的主体身份——请改用带图像参考的 edit 端点。
• 请求 4 个分辨率档位之外的分辨率 → 422。
• 请求 11 种受支持值之外的宽高比 → 422。
• 图中文字未加引号 → 渲染结果不可预测。

擅长的场景

用例	Nano Banana 2 的优势
营销草稿缩略图（每批 4 张）	先以 0.5K 快速迭代，再将最佳结果提升至 2K
适配社交平台原生比例	支持多种宽高比，包括 9:16、4:5、21:9
海报／卡片中的文字排版	将字符加上引号后，文本渲染更可预测
结合 Web 信息的时事图像	enable_web_search 可整合最新信息
可复现的变体测试	种子稳定，构图一致

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

电影感肖像（页面示例）：

A cinematic close-up portrait of an American woman standing under neon
lights in rainy Tokyo, shallow depth of field, reflective wet streets,
ultra-detailed, realistic skin texture

带有引用文字的品牌素材卡片：

A minimalist 16:9 product card: a matte black ceramic mug centered on a
soft warm-grey paper background, rim highlight from upper-left, the
headline "Brewed Quietly" in clean bold sans-serif top-right, balanced
negative space below, e-commerce ready, clean studio lighting

适配竖屏平台原生比例：

A 9:16 vertical hero for a wellness brand: a single ceramic teacup on a
linen runner, soft morning side-light, the words "Slow Down" in
hand-drawn serif large at the top, gentle steam rising, neutral color
palette, uncluttered

限制

• 仅支持静态图像。 此端点不支持视频。
• 每次请求最多输出 4 张图像。
• Web 搜索会增加延迟和成本——仅在需要时启用。
• 2K／4K 成本更高——除非用户要求更高分辨率，否则默认使用 1K。
• 编辑图像请使用 /edit 端点——不要使用此端点。

退出码

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

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

工作原理

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

安全与隐私

• 令牌存储：runcomfy login 会以 0600 模式（仅所有者可读写）将 API 令牌写入 ~/.config/runcomfy/token.json。在 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 的单次下载，以防恶意或失控的模型输出耗尽磁盘空间。