mcpField
N
nanobanana

nanobanana

github.com/gargantuax创意与媒体710.6k 次安装27 周前更新
代码仓库

关于 nanobanana

这是一个使用 Gemini 原生 Nano Banana 模型生成和编辑图像的 Python 技能，提供模型别名、选项校验、批量生成、预演及自定义 Gemini 兼容端点。

主要功能

  1. 01文本生成图像
  2. 02使用多个参考图像编辑
  3. 03批量生成多个版本
  4. 04模型别名和选项校验
  5. 05预演及自定义端点

适用场景

  1. 01根据文本提示创建图像
  2. 02使用本地参考图像进行编辑
  3. 03批量生成多个设计版本
  4. 04提交前检查请求设置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gargantuax/openskills --skill nanobanana

安装后在 Claude Code 中输入/nanobanana确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
agents/
openai.yaml
references/
config.md
models-and-api.md
scripts/
nanobanana.py
tests/
test_nanobanana.py

详细介绍

Nano Banana

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

工作流

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

命令

单次文生图请求：

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

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

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 兼容网关：

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

批量生成五个变体：

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

检查最终请求，但不发送：

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 标志会覆盖两者。
  • 切勿打印密钥。
  • 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，以最大限度提高网关兼容性。

资源

评论

支持 Markdown