mcpField
N
nano-banana-pro

nano-banana-pro

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

关于 nano-banana-pro

nano-banana-pro 是一项通过 Google's Nano Banana Pro API（Gemini 3 Pro Image）生成图像和编辑现有图像的 skill，支持 1K、2K 和 4K 分辨率。

主要功能

  1. 01根据提示词生成图像
  2. 02按指令编辑图像
  3. 03选择 1K、2K 或 4K 分辨率
  4. 04将 PNG 保存到工作目录

适用场景

  1. 01根据描述创建图像
  2. 02更改图像元素或风格

安装

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

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

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

附带文件scripts/generate_image.py

详细介绍

Nano Banana Pro 图像生成与编辑

使用 Google 的 Nano Banana Pro API（Gemini 3 Pro Image）生成新图像或编辑现有图像。

用法

使用绝对路径运行脚本（请勿先 cd 到 skill 目录）：

生成新图像：

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 1K|2K|4K] [--api-key KEY]

编辑现有图像：

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K] [--api-key KEY]

**重要提示：**始终从用户当前的工作目录运行，这样图像会保存在用户工作的目录中，而不是 skill 目录中。

分辨率选项

Gemini 3 Pro Image API 支持三种分辨率（必须使用大写 K）：

  • 1K（默认）- 约 1024px 分辨率
  • 2K - 约 2048px 分辨率
  • 4K - 约 4096px 分辨率

将用户请求映射到 API 参数：

  • 未提及分辨率 → 1K
  • “低分辨率”、“1080”、“1080p”、“1K” → 1K
  • “2K”、“2048”、“普通”、“中等分辨率” → 2K
  • “高分辨率”、“高清”、“高保真”、“4K”、“超高” → 4K

API 密钥

脚本按以下顺序检查 API 密钥：

  1. --api-key 参数（用户在聊天中提供密钥时使用）
  2. GEMINI_API_KEY 环境变量

如果两者都不可用，脚本会报错退出。

文件名生成

按此格式生成文件名：yyyy-mm-dd-hh-mm-ss-name.png

格式：{timestamp}-{descriptive-name}.png

  • 时间戳：当前日期/时间，格式为 yyyy-mm-dd-hh-mm-ss（24 小时制）
  • 名称：简短的描述性小写文本，单词之间用连字符分隔
  • 描述部分应简洁（通常为 1-5 个单词）
  • 使用用户提示词或对话中的上下文
  • 如果不明确，使用随机标识符（例如 x9k2、a7b3）

示例：

  • 提示词“A serene Japanese garden” → 2025-11-23-14-23-05-japanese-garden.png
  • 提示词“sunset over mountains” → 2025-11-23-15-30-12-sunset-mountains.png
  • 提示词“create an image of a robot” → 2025-11-23-16-45-33-robot.png
  • 上下文不明确 → 2025-11-23-17-12-48-x9k2.png

图像编辑

用户想要修改现有图像时：

  1. 检查用户是否提供了图像路径，或提及当前目录中的某张图像
  2. 使用 --input-image 参数指定图像路径
  3. 提示词应包含编辑说明（例如“让天空更有戏剧性”、“移除人物”、“改成卡通风格”）
  4. 常见编辑任务：添加/移除元素、更改风格、调整颜色、模糊背景等

提示词处理

**生成图像：**将用户的图像描述原样传递给 --prompt。只有在描述明显不充分时才重新整理。

**编辑图像：**将编辑说明传递给 --prompt（例如“在天空中添加一道彩虹”、“让它看起来像一幅水彩画”）。

无论哪种情况，都要保留用户的创作意图。

输出

  • 将 PNG 保存到当前目录（如果文件名包含目录，则保存到指定路径）
  • 脚本会输出生成图像的完整路径
  • 不要读取图像——只需告知用户保存路径

示例

生成新图像：

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K

编辑现有图像：

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "make the sky more dramatic with storm clouds" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K

评论

支持 Markdown