nanobanana

Nano Banana

一个统一的Python入口，用于Gemini原生Nano Banana图像生成与编辑，支持模型别名、严格选项验证、批量运行和自定义端点。

工作流程

1. 打开 references/config.md 选择环境变量和覆盖顺序。
2. 打开 references/models-and-api.md 选择合适的Nano Banana层级并查看模型特定约束。
3. 优先使用 gemini-3.1-flash-image-preview（nanobanana-2），除非你需要最快的低成本默认模型（nanobanana）或最高保真度的推理模型（nanobanana-pro）。
4. 运行 scripts/nanobanana.py generate 进行单次请求，或 scripts/nanobanana.py batch 进行重复变体。
5. 当主要风险在于请求体结构、端点或模型特定选项支持时，先添加 --dry-run。
6. 当需要使用自定义Gemini兼容网关时，传递 --base-url 或 GEMINI_BASE_URL。
7. 在 generate 命令中添加 --save-response <path> 以保存原始JSON响应体用于调试。

命令

单次文本生成图像请求：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "开发者工具的复古未来主义产品主图" `
  --output .\out\hero.png `
  --model nanobanana-2 `
  --ratio 16:9 `
  --size 2K

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

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "将这些参考图转化为一张清晰的发布海报，标题文字清晰可读" `
  --input-image .\refs\subject.png `
  --input-image .\refs\background.png `
  --output .\out\poster.png `
  --model nanobanana-pro `
  --ratio 4:5 `
  --size 2K

使用自定义Gemini兼容网关：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "一个大胆的吉祥物贴纸包" `
  --output .\out\stickers.png `
  --base-url http://your-gateway.example.com/v1beta `
  --auth-mode bearer

批量生成五个变体：

python .\skills\nanobanana\scripts\nanobanana.py batch `
  --prompt "PDF工作流产品的极简应用图标" `
  --count 5 `
  --dir .\out\icons `
  --prefix icon `
  --model nanobanana `
  --ratio 1:1

检查最终请求但不发送：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "AI代理工作的编辑插图" `
  --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标志覆盖两者。
• 切勿打印密钥。
• 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