mcpField
N
nanobanana-skill

nanobanana-skill

github.com/feiskyer创意与媒体1.7k321 次安装4 周前更新
代码仓库

关于 nanobanana-skill

通过 nanobanana 工具调用 Google Gemini API 来生成和编辑图像的技能。它运行 Python 脚本，并支持选择模型、尺寸和分辨率。

主要功能

  1. 01根据文本提示生成图像
  2. 02编辑一张或多张输入图像
  3. 03可选 Gemini 图像模型
  4. 04宽高比与分辨率选项
  5. 05可选 Google Search grounding

适用场景

  1. 01根据文字描述创建图像
  2. 02按提示修改现有图像

安装

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

$npx skills add https://github.com/feiskyer/claude-code-settings --skill nanobanana-skill

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

附带文件nanobanana.pyrequirements.txt

详细介绍

Nanobanana 图像生成技能

通过 nanobanana 工具使用 Google Gemini API 生成或编辑图像。

要求

  1. GEMINI_API_KEY：必须在 ~/.nanobanana.env 中配置，或通过 export GEMINI_API_KEY=<your-api-key> 设置
  2. 已安装依赖包的 Python3：google-genai、Pillow、python-dotenv。如果尚未安装，可通过 python3 -m pip install -r ${CLAUDE_SKILL_DIR}/requirements.txt 安装。
  3. 可执行文件：${CLAUDE_SKILL_DIR}/nanobanana.py

说明

生成图像

  1. 询问用户：

    • 想要创作什么（提示词）
    • 期望的纵横比／尺寸（可选，默认为竖版 9:16）
    • 输出文件名（可选；如果未指定，则自动生成 UUID）
    • 模型偏好（可选，默认为 gemini-3.1-flash-image-preview）
    • 分辨率（可选，默认为 1K）

  2. 使用适当的参数运行 nanobanana 脚本：

    python3 ${CLAUDE_SKILL_DIR}/nanobanana.py --prompt "description of image" --output "filename.png"

  3. 完成后向用户显示已保存的图像路径

编辑图像

  1. 询问用户：

    • 要编辑的输入图像文件
    • 想要进行哪些更改（提示词）
    • 输出文件名（可选）

  2. 使用输入图像运行：

    python3 ${CLAUDE_SKILL_DIR}/nanobanana.py --prompt "editing instructions" --input image1.png image2.png --output "edited.png"

可用选项

纵横比（--size）
  • 1024x1024 (1:1) - 正方形
  • 832x1248 (2:3) - 竖版
  • 1248x832 (3:2) - 横版
  • 864x1184 (3:4) - 竖版
  • 1184x864 (4:3) - 横版
  • 896x1152 (4:5) - 竖版
  • 1152x896 (5:4) - 横版
  • 768x1344 (9:16) - 竖版（默认）
  • 1344x768 (16:9) - 横版
  • 1536x672 (21:9) - 超宽
模型（--model）
  • gemini-3.1-flash-image-preview（默认）- 最新，生成速度快
  • gemini-3-pro-image-preview - 质量更高，支持思考／推理
分辨率（--resolution）
  • 1K（默认）
  • 2K
  • 4K
其他选项
  • --no-search - 禁用 Google Search grounding（默认启用）
  • --no-think - 禁用思考／推理模式

示例

生成简单图像
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py --prompt "A serene mountain landscape at sunset with a lake"
使用指定尺寸和输出路径生成图像
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Modern minimalist logo for a tech startup" \
  --size 1024x1024 \
  --output "logo.png"
生成高分辨率横版图像
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Futuristic cityscape with flying cars" \
  --size 1344x768 \
  --resolution 2K \
  --output "cityscape.png"
编辑现有图像
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Add a rainbow in the sky" \
  --input photo.png \
  --output "photo-with-rainbow.png"
使用 pro 模型获得更高质量
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Detailed portrait of a cat in watercolor style" \
  --model gemini-3-pro-image-preview \
  --output "cat-portrait.png"

错误处理

如果脚本运行失败：

  • 检查是否已导出 GEMINI_API_KEY，或是否已在 ~/.nanobanana.env 中设置
  • 确认输入图像文件存在且可读取
  • 确保输出目录可写
  • 如果未生成图像，请尝试在提示词中更明确地说明需要生成图像

最佳实践

  1. 提示词应尽量详细，包括风格、氛围、颜色和构图
  2. 对于徽标／图形，使用正方形纵横比（1024x1024）
  3. 对于社交媒体帖子，限时动态使用 9:16，帖子使用 1:1
  4. 对于壁纸，使用 16:9 或 21:9
  5. 测试时从 1K 分辨率开始，最终输出时升级到 2K／4K
  6. 追求最佳质量时使用 gemini-3-pro-image-preview，追求速度时使用 gemini-3.1-flash-image-preview（默认）

评论

支持 Markdown