Nano Banana AI 图像生成工具：使用 Gemini 3 Pro 生成与编辑高分辨率图像

nanobanana by resciencelab/opc-skills

1,200 周安装量

628 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/resciencelab/opc-skills --skill nanobanana

AI/机器学习开发设计

🇨🇳中文介绍

Nano Banana - AI 图像生成

使用 Google 的 Gemini 3 Pro Image 模型（gemini-3-pro-image-preview，昵称 "Nano Banana Pro" 🍌）生成和编辑图像。

前提条件

必需项：

GEMINI_API_KEY - 从 Google AI Studio 获取
Python 3.10+ 及 google-genai 包

安装依赖：

pip install google-genai pillow

快速开始

生成图像：

python3 <skill_dir>/scripts/generate.py "一个可爱的机器人吉祥物，像素艺术风格" -o robot.png

编辑现有图像：

python3 <skill_dir>/scripts/generate.py "把背景变成蓝色" -i input.jpg -o output.png

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

使用特定宽高比生成：

python3 <skill_dir>/scripts/generate.py "电影级风景" --ratio 21:9 -o landscape.png

生成高分辨率 4K 图像：

python3 <skill_dir>/scripts/generate.py "专业产品照片" --size 4K -o product.png

`scripts/generate.py`

主要的图像生成脚本。

Usage: generate.py [OPTIONS] PROMPT

Arguments:
  PROMPT              图像生成的文本提示

Options:
  -o, --output PATH   输出文件路径（默认：自动生成）
  -i, --input PATH    用于编辑的输入图像（可选）
  -r, --ratio RATIO   宽高比（1:1, 16:9, 9:16, 21:9 等）
  -s, --size SIZE     图像尺寸：2K 或 4K（默认：标准）
  --search            启用 Google 搜索基础以提升准确性
  -v, --verbose       显示详细输出

支持的宽高比：

1:1 - 正方形（默认）
2:3, 3:2 - 纵向/横向
3:4, 4:3 - 标准
4:5, 5:4 - 照片
9:16, 16:9 - 宽屏
21:9 - 超宽屏/电影比例

`scripts/batch_generate.py`

生成多个图像并使用顺序命名。

Usage: batch_generate.py [OPTIONS] PROMPT

Arguments:
  PROMPT              图像生成的文本提示

Options:
  -n, --count N       要生成的图像数量（默认：10）
  -d, --dir PATH      输出目录
  -p, --prefix STR    文件名前缀（默认："image"）
  -r, --ratio RATIO   宽高比
  -s, --size SIZE     图像尺寸（2K/4K）
  --delay SECONDS     生成间隔延迟（默认：3）

python3 <skill_dir>/scripts/batch_generate.py "像素艺术标志" -n 20 -d ./logos -p logo

你也可以直接使用模块：

from generate import generate_image, edit_image

# 生成图像
result = generate_image(
    prompt="夜晚的未来城市",
    output_path="city.png",
    aspect_ratio="16:9",
    image_size="4K"
)

# 编辑现有图像
result = edit_image(
    prompt="在天空中添加飞行汽车",
    input_path="city.png",
    output_path="city_edited.png"
)

变量	描述	默认值
`GEMINI_API_KEY`	Google Gemini API 密钥	必需
`IMAGE_OUTPUT_DIR`	默认输出目录	`./nanobanana-images`

文本到图像生成

根据文本描述创建图像。该模型擅长：

逼真的图像
艺术风格（像素艺术、插画等）
产品摄影
风景和场景

使用自然语言转换现有图像：

风格迁移
对象添加/移除
背景更改
颜色调整

标准：生成速度快，质量良好
2K：增强细节（2048px）
4K：最高质量（3840px），最适合文本渲染

启用 --search 以获取涉及以下内容的、事实准确的图像：

真实人物、地点、地标
当前事件
特定产品或品牌

好的提示词包含：

主体描述
风格/美学
光照和氛围
构图细节
调色板

"一个舒适的咖啡馆内部，温暖的灯光，复古美学，
木制家具，架子上的植物，早晨阳光透过窗户，
背景柔焦，35mm 胶片摄影风格"

生成 10-20 个变体以探索选项
使用一致的提示词以保持风格连贯性
添加 3-5 秒延迟以避免速率限制
查看结果并对最佳候选进行迭代

Gemini API 有使用配额
在批量生成之间添加延迟
在 Google AI Studio 检查你的配额

"未找到 API 密钥"

设置 GEMINI_API_KEY 环境变量
或通过 --api-key 选项传递

"响应中没有图像"

提示词可能触发了安全过滤器
尝试重新措辞以避免敏感内容

"超出速率限制"

等待几秒钟后重试
减小批量大小或增加延迟时间

references/prompts.md - 按类别划分的提示词示例
examples/ - 示例使用脚本

🇺🇸English

Nano Banana - AI Image Generation

Generate and edit images using Google's Gemini 3 Pro Image model (gemini-3-pro-image-preview, nicknamed "Nano Banana Pro" 🍌).

Prerequisites

Required:

GEMINI_API_KEY - Get from Google AI Studio
Python 3.10+ with google-genai package

Install dependencies:

pip install google-genai pillow

Quick Start

Generate an image:

python3 <skill_dir>/scripts/generate.py "a cute robot mascot, pixel art style" -o robot.png

Edit an existing image:

python3 <skill_dir>/scripts/generate.py "make the background blue" -i input.jpg -o output.png

Generate with specific aspect ratio:

python3 <skill_dir>/scripts/generate.py "cinematic landscape" --ratio 21:9 -o landscape.png

Generate high-resolution 4K image:

python3 <skill_dir>/scripts/generate.py "professional product photo" --size 4K -o product.png

Script Reference

`scripts/generate.py`

Main image generation script.

Usage: generate.py [OPTIONS] PROMPT

Arguments:
  PROMPT              Text prompt for image generation

Options:
  -o, --output PATH   Output file path (default: auto-generated)
  -i, --input PATH    Input image for editing (optional)
  -r, --ratio RATIO   Aspect ratio (1:1, 16:9, 9:16, 21:9, etc.)
  -s, --size SIZE     Image size: 2K or 4K (default: standard)
  --search            Enable Google Search grounding for accuracy
  -v, --verbose       Show detailed output

Supported aspect ratios:

1:1 - Square (default)
2:3, 3:2 - Portrait/Landscape
3:4, 4:3 - Standard
4:5, 5:4 - Photo
9:16, 16:9 - Widescreen
21:9 - Ultra-wide/Cinematic

`scripts/batch_generate.py`

Generate multiple images with sequential naming.

Usage: batch_generate.py [OPTIONS] PROMPT

Arguments:
  PROMPT              Text prompt for image generation

Options:
  -n, --count N       Number of images to generate (default: 10)
  -d, --dir PATH      Output directory
  -p, --prefix STR    Filename prefix (default: "image")
  -r, --ratio RATIO   Aspect ratio
  -s, --size SIZE     Image size (2K/4K)
  --delay SECONDS     Delay between generations (default: 3)

Example:

python3 <skill_dir>/scripts/batch_generate.py "pixel art logo" -n 20 -d ./logos -p logo

Python API

You can also use the module directly:

from generate import generate_image, edit_image

# Generate image
result = generate_image(
    prompt="a futuristic city at night",
    output_path="city.png",
    aspect_ratio="16:9",
    image_size="4K"
)

# Edit existing image
result = edit_image(
    prompt="add flying cars to the sky",
    input_path="city.png",
    output_path="city_edited.png"
)

Environment Variables

Variable	Description	Default
`GEMINI_API_KEY`	Google Gemini API key	Required
`IMAGE_OUTPUT_DIR`	Default output directory	`./nanobanana-images`

Features

Text-to-Image Generation

Create images from text descriptions. The model excels at:

Photorealistic images
Artistic styles (pixel art, illustration, etc.)
Product photography
Landscapes and scenes

Image Editing

Transform existing images with natural language:

Style transfer
Object addition/removal
Background changes
Color adjustments

High-Resolution Output

Standard : Fast generation, good quality
2K : Enhanced detail (2048px)
4K : Maximum quality (3840px), best for text rendering

Google Search Grounding

Enable --search for factually accurate images involving:

Real people, places, landmarks
Current events
Specific products or brands

Best Practices

Prompt Writing

Good prompts include:

Subject description
Style/aesthetic
Lighting and mood
Composition details
Color palette

Example:

"A cozy coffee shop interior, warm lighting, vintage aesthetic, 
wooden furniture, plants on shelves, morning sunlight through windows, 
soft focus background, 35mm film photography style"

Batch Generation Tips

Generate 10-20 variations to explore options
Use consistent prompts for style coherence
Add 3-5 second delays to avoid rate limits
Review results and iterate on best candidates

Rate Limits

Gemini API has usage quotas
Add delays between batch generations
Check your quota at Google AI Studio

Troubleshooting

"API key not found"

Set GEMINI_API_KEY environment variable
Or pass via --api-key option

"No image in response"

Prompt may have triggered safety filters
Try rephrasing to avoid sensitive content

"Rate limit exceeded"

Wait a few seconds and retry
Reduce batch size or add longer delays

References

references/prompts.md - Prompt examples by category
examples/ - Example usage scripts

Weekly Installs

1.2K

Repository

resciencelab/opc-skills

GitHub Stars

628

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykPass

Installed on

opencode967

gemini-cli961

codex950

github-copilot902

cursor886

claude-code857

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装

Nano Banana AI 图像生成工具：使用 Gemini 3 Pro 生成与编辑高分辨率图像

🇨🇳中文介绍

Nano Banana - AI 图像生成

前提条件

快速开始

生成图像：

编辑现有图像：

相关 Skills

使用特定宽高比生成：

生成高分辨率 4K 图像：

脚本参考

scripts/generate.py

scripts/batch_generate.py

Python API

环境变量

功能特性

文本到图像生成

图像编辑

高分辨率输出

Google 搜索基础

最佳实践

提示词撰写

批量生成技巧

速率限制

故障排除

参考

🇺🇸English

Nano Banana - AI Image Generation

Prerequisites

Quick Start

Generate an image:

Edit an existing image:

Generate with specific aspect ratio:

Generate high-resolution 4K image:

Script Reference

scripts/generate.py

scripts/batch_generate.py

Python API

Environment Variables

Features

Text-to-Image Generation

Image Editing

High-Resolution Output

Google Search Grounding

Best Practices

Prompt Writing

Batch Generation Tips

Rate Limits

Troubleshooting

References

最新 Skills

`scripts/generate.py`

`scripts/batch_generate.py`

`scripts/generate.py`

`scripts/batch_generate.py`