mcpField
N
nano-banana-2

nano-banana-2

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

关于 nano-banana-2

nano-banana-2 是一项使用 `gemini-3.1-flash-image-preview` 生成和编辑图像的技能。它通过脚本接收提示词与参考图，并可指定分辨率和宽高比。

主要功能

  1. 01生成新图像或编辑现有图像
  2. 02支持最多 14 张参考图
  3. 03提供 512px 至 4K 分辨率选项
  4. 04支持多种宽高比
  5. 05从参数或环境变量读取 API 密钥

适用场景

  1. 01生成符合描述的新图像
  2. 02依据一张或多张图像进行编辑
  3. 03按指定分辨率和比例制作图像

安装

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

$npx skills add https://github.com/intellectronica/agent-skills --skill nano-banana-2

安装后在 Claude Code 中输入/nano-banana-2确认已加载。

附带文件scripts/generate_image.py

详细介绍

Nano Banana 2 图像生成与编辑

使用 Nano Banana 2（gemini-3.1-flash-image-preview）生成新图像或编辑现有图像。

用法

使用绝对路径或相对于工作区的路径运行脚本（请勿先切换到技能目录）：

生成新图像：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 512px|1K|2K|4K] [--aspect-ratio RATIO] [--api-key KEY]

使用参考图像编辑图像：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input1.png" [--input-image "path/to/input2.png" ...] [--resolution 512px|1K|2K|4K] [--aspect-ratio RATIO] [--api-key KEY]

始终从用户当前的工作目录运行，这样输出便会保存在当前项目上下文中。

模型

使用模型代码：

  • gemini-3.1-flash-image-preview（Nano Banana 2）

此技能中请勿使用 gemini-3-pro-image-preview。

分辨率选项

Nano Banana 2 支持：

  • 512px（速度最快、延迟最低，适合迭代）
  • 1K（默认）
  • 2K
  • 4K

将常见用户用语映射为：

  • “quick draft”“thumbnail”“tiny”“512”“0.5K” → 512px
  • 未提及分辨率 → 1K
  • “2K”“medium”“normal” → 2K
  • “4K”“high-res”“ultra”“print quality” → 4K

1K、2K、4K 中的 K 使用大写。

宽高比

支持的宽高比：

  • 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9

将常见请求映射为：

  • 方形帖子 / 图标 → 1:1
  • 手机壁纸 / 竖屏短视频 → 9:16
  • 宽屏 / 幻灯片 / 主视觉图 → 16:9
  • 电影宽画幅 → 21:9
  • 竖版印刷品 → 2:3 或 3:4
  • 全景横幅 → 4:1 或 8:1

如果未指定，则使用模型的默认行为。

参考图像（Gemini 3 图像工作流新增）

需要时，可通过重复使用 --input-image 提供最多 14 张参考图像：

  • 保持角色一致性
  • 保持物体细节准确
  • 将多张视觉参考图像合并为一个输出

简单编辑使用一张图像；构图或对一致性要求较高的任务使用多张图像。

API 密钥

按以下顺序获取 API 密钥：

  1. --api-key 参数
  2. GEMINI_API_KEY 环境变量

如果没有可用密钥，请停止并报告明确的错误。

文件名生成

文件名格式为：yyyy-mm-dd-hh-mm-ss-name.png

示例：

  • 2026-02-26-17-31-04-japanese-garden.png
  • 2026-02-26-17-31-59-social-banner.png

提示词处理

生成图像时，除非用户的请求存在严重的信息不足，否则原样传递用户请求。 编辑图像时，在提示词中加入明确的变换指令，并保留原始意图。

输出

  • 将 PNG 保存到当前目录（或保存到 --filename 中提供的路径）
  • 返回完整的保存路径
  • 除非用户明确要求，否则不要重新读取输出图像

示例

创建 4K 宽屏图像：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "Futuristic city skyline at blue hour with neon reflections" --filename "2026-02-26-17-45-00-futuristic-skyline.png" --resolution 4K --aspect-ratio 16:9

使用多张参考图像编辑：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "Create a polished campaign image that keeps the exact logo details and character identity" --filename "2026-02-26-17-50-10-campaign-image.png" --input-image "logo.png" --input-image "character.png" --resolution 2K --aspect-ratio 4:5

评论

支持 Markdown