nanobanana

原文：🇺🇸 英文

已翻译

包含 2 个脚本

基于Gemini原生的Nano Banana图像生成与编辑工具，支持Nano Banana、Nano Banana 2和Nano Banana Pro版本。适用于文本生成图像、图像编辑、多本地参考图生成、批量生成、预演请求检查，或使用自定义Gemini兼容基础URL（如自托管网关）的场景。

10.3k次下载

来源gargantuax/openskills

添加于2026-04-30

NPX安装

npx skill4agent add gargantuax/openskills nanobanana

SKILL.md 内容（中文）

查看翻译对照 →

Nano Banana

一款基于Gemini原生的Nano Banana图像生成与编辑工具的Python统一入口，支持模型别名、严格参数验证、批量运行以及自定义端点功能。

工作流程

打开references/config.md选择环境变量及优先级覆盖规则。
打开references/models-and-api.md选择合适的Nano Banana版本，并查看模型特定约束。
除非你需要最快低成本的默认版本（
```
nanobanana
```
）或最高保真度的推理模型（
```
nanobanana-pro
```
），否则优先选择
```
gemini-3.1-flash-image-preview
```
（对应
```
nanobanana-2
```
）。

运行

scripts/nanobanana.py generate

执行单次请求，或运行

scripts/nanobanana.py batch

生成多个变体。

当主要风险在于请求负载格式、端点或模型特定参数支持时，先添加
```
--dry-run
```
参数进行预演。
当需要使用自定义Gemini兼容网关时，传入
```
--base-url
```
参数或设置
```
GEMINI_BASE_URL
```
环境变量。
在
```
generate
```
命令中添加
```
--save-response <path>
```
参数，可保存原始JSON响应体用于调试。

命令示例

单文本生成图像请求：

powershell

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "A retro-futurist product hero illustration for a developer tool" `
  --output .\out\hero.png `
  --model nanobanana-2 `
  --ratio 16:9 `
  --size 2K

使用两张本地参考图编辑现有图像：

powershell

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "Turn these references into a clean launch poster with legible title text" `
  --input-image .\refs\subject.png `
  --input-image .\refs\background.png `
  --output .\out\poster.png `
  --model nanobanana-pro `
  --ratio 4:5 `
  --size 2K

使用自定义Gemini兼容网关：

powershell

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "A bold mascot sticker pack" `
  --output .\out\stickers.png `
  --base-url http://your-gateway.example.com/v1beta `
  --auth-mode bearer

批量生成5个变体：

powershell

python .\skills\nanobanana\scripts\nanobanana.py batch `
  --prompt "Minimal app icon for a PDF workflow product" `
  --count 5 `
  --dir .\out\icons `
  --prefix icon `
  --model nanobanana `
  --ratio 1:1

预演请求（不实际发送）：

powershell

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "An editorial illustration of AI agents at work" `
  --model nanobanana-2 `
  --output .\out\agents.png `
  --dry-run

规则说明

```
--model
```
参数接受别名
```
nanobanana
```
、
```
nanobanana-2
```
、
```
nanobanana-pro
```
，或精确的Gemini模型ID。

nanobanana

对应

gemini-2.5-flash-image

，

nanobanana-2

对应

gemini-3.1-flash-image-preview

，

nanobanana-pro

对应

gemini-3-pro-image-preview

。

```
image_size
```
仅在Gemini 3图像模型上有效；
```
nanobanana
```
版本不支持
```
--size
```
参数。
512分辨率仅在
```
nanobanana-2
```
版本上有效。
环境变量会覆盖
```
.env
```
文件配置；CLI参数会同时覆盖环境变量和
```
.env
```
配置。
绝不打印敏感信息。
```
generate
```
命令接受重复的
```
--input-image
```
路径，用于图像编辑或多参考图生成。

--base-url

应指向Gemini API根路径，例如

https://generativelanguage.googleapis.com/v1beta

，而非直接指向

/models/...

。

```
--auth-mode auto
```
在官方Google端点使用
```
x-goog-api-key
```
，在自定义端点同时发送
```
Authorization: Bearer
```
和
```
x-goog-api-key
```
，以最大化网关兼容性。

资源链接

脚本：scripts/nanobanana.py
配置参考：references/config.md
模型与API参考：references/models-and-api.md

nanobanana

NPX安装

标签

SKILL.md 内容（中文）

Nano Banana

工作流程

命令示例

规则说明

资源链接