nano-banana-2

原文：🇺🇸 英文

已翻译

在RunComfy上使用Google Nano Banana 2（Gemini家族闪存级文本生成图像模型）生成图像——该技能集成了模型官方文档中的提示模式，相比直接使用该模型的普通提示，能输出更优质的结果。文档介绍了Nano Banana 2的优势（快速迭代、图像内文字渲染、可预测构图、可选联网上下文）、分辨率层级定价、安全容忍度调节，以及何时转而使用Nano Banana Pro / GPT Image 2 / Flux 2 / Seedream。通过本地RunComfy CLI调用`runcomfy run google/nano-banana-2/text-to-image`。当触发关键词为"nano banana"、"nano-banana-2"、"nano banana 2"、"google image gen"、"gemini image"，或明确要求使用该模型生成图像时启动。

408.1k次下载

来源prime-skills/runcomfy-agent-skills

添加于2026-08-08

NPX安装

npx skill4agent add prime-skills/runcomfy-agent-skills nano-banana-2

SKILL.md 内容（中文）

查看翻译对照 →

RunComfy上的Nano Banana 2专业套件

runcomfy.com · 模型页面 · GitHub

Google Nano Banana 2——Gemini家族中的闪存级文本生成图像模型——托管在RunComfy Model API上。针对创意构思、社交媒体缩略图批量生成和快速草稿进行优化，具备出色的图像内文字渲染能力。

bash

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

何时选择该模型（对比同类模型）

Nano Banana 2是谷歌图像生成产品线中的闪存级模型。当迭代速度和可预测构图比极致细节更重要时，选择它。

你的需求	适用模型
快速草稿、社交媒体缩略图、批量变体生成	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。

前置条件

RunComfy CLI —
```
npm i -g @runcomfy/cli
```
RunComfy账户 —
```
runcomfy login
```
会打开浏览器设备码登录流程。
CI/容器环境 — 设置环境变量
```
RUNCOMFY_TOKEN=<token>
```
替代
```
runcomfy login
```
。

端点与输入 schema

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

字段	类型	必填	默认值	说明
`prompt`	字符串	是	—	以主体为优先的描述文本。
`num_images`	整数	否	1	1–4。创意构思阶段建议用4。
`seed`	整数	否	0	重复使用可保证结果可复现。
`aspect_ratio`	枚举值	否	`auto`	`auto` , `21:9` , `16:9` , `3:2` , `4:3` , `5:4` , `1:1` , `4:5` , `3:4` , `2:3` , `9:16` 。
`resolution`	枚举值	否	`1K`	`0.5K` （草稿）, `1K` （默认）, `2K` （终稿）, `4K` （最高）。
`output_format`	枚举值	否	`png`	`png` , `jpeg` , `webp` 。
`safety_tolerance`	整数	否	4	1（严格）– 6（宽松）。
`limit_generations`	布尔值	否	true	限制每个提示轮次仅生成一次。
`enable_web_search`	布尔值	否	false	添加联网关联功能（额外费用+延迟）。

如需图像编辑（保留主体并修改），请查看同系列的

nano-banana-edit

技能。

调用方式

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

bash

runcomfy run google/nano-banana-2/text-to-image \
  --input '{"prompt": "<用户提示>"}' \
  --output-dir <绝对路径>

垂直方向4张批量生成（用于创意构思）：

bash

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<用户提示>",
    "num_images": 4,
    "aspect_ratio": "9:16",
    "resolution": "0.5K"
  }' \
  --output-dir <绝对路径>

2K分辨率终稿（锁定种子）：

bash

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<用户提示>",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "seed": 42
  }' \
  --output-dir <绝对路径>

联网关联（时事/真实实体）：

bash

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<引用本周真实事件的提示>",
    "enable_web_search": true
  }' \
  --output-dir <绝对路径>

提示技巧——有效的方法

主体优先的陈述式语法。例如："美国女性站在东京雨夜的霓虹灯下的电影感特写肖像，浅景深，湿漉漉的反光街道，超细节，写实皮肤纹理"——先讲主体，再讲动作、环境、风格、镜头。主体前置，指令后置。

图像内文字用精确引号包裹。例如："标签上用简洁粗体无衬线字体写着'AURA'，居中，黑底白字"——用引号包裹文字内容，指定位置和字体风格。不要只说"上面有品牌名"然后碰运气。

用固定种子优化迭代。当针对单个提示做小变体迭代时，锁定

seed

——保持构图稳定。

谨慎使用联网关联。仅当提示涉及时事/真实实体时开启

enable_web_search

。会增加延迟和成本；默认关闭。

不要混合冲突风格。"极简+华丽+复古+赛博朋克"会相互抵消。选择1-2种核心风格。

反模式：

尝试用文字描述稳定的主体身份——改用带图像参考的编辑端点。
请求4个层级之外的分辨率→返回422错误。
使用11种支持比例之外的宽高比→返回422错误。
未加引号的图像内文字→渲染结果不可预测。

优势场景

使用场景	选择Nano Banana 2的原因
营销草稿缩略图（批量4张）	0.5K分辨率下快速迭代，再将最优版本升级到2K
社交媒体原生内容	支持多种宽高比，包括9:16、4:5、21:9
海报/卡片的图像内文字	当文字用引号包裹时，渲染结果可预测
联网关联的时事图像	`enable_web_search` 集成最新信息
可复现的变体测试	稳定的种子+一致的构图

验证有效的示例提示

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

美国女性站在东京雨夜的霓虹灯下的电影感特写肖像，浅景深，湿漉漉的反光街道，超细节，写实皮肤纹理

带引号文字的品牌资产卡片：

极简风格16:9产品卡片：哑光黑色陶瓷马克杯居中放在柔和暖灰色纸背景上，左上角有边缘高光，右上角用简洁粗体无衬线字体写着"Brewed Quietly"，下方留有均衡留白，适合电商，干净的影棚灯光

垂直平台原生内容：

健康品牌的9:16垂直主视觉：亚麻桌 runner 上放着一个陶瓷茶杯，柔和的晨间侧光，顶部用手绘衬线字体写着大的"Slow Down"，轻柔蒸汽升起，中性色调，简洁整洁

限制

仅支持静态图像。该端点不支持视频生成。
每次请求最多生成4张图像。
联网搜索会增加延迟和成本——仅按需开启。
2K/4K分辨率成本更高——默认用1K，除非用户明确要求更高分辨率。
图像编辑请使用
/edit
端点——不要用这个端点。

退出码

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

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

工作原理

该技能调用

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

，传入符合schema的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
```
会将API令牌写入
```
~/.config/runcomfy/token.json
```
，权限为0600（仅所有者可读可写）。在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的单个下载，防止恶意或异常模型输出占满磁盘。