AI 图像生成与精修工作室
6 种生图模板 + 9 种精修模板，覆盖电商主图、营销 Banner、详情页、背景替换、画质增强、风格迁移全场景。基于 Google Gemini API，零第三方依赖，Python 3 即用。
FEATURES
6 种专业模板：主图、Banner、详情页、生活场景、四宫格、社媒。自动增强 Prompt 为商业级摄影指令。
9 种精修模板：背景替换/移除/白化、质量增强、人像修图、物品替换、风格迁移、调色、画布扩展。
3 款 Gemini 模型，从快速预览到 4K 影棚画质。根据场景自动推荐或手动指定。
支持传入参考图片进行图生图，保持一致性风格。Gemini 3+ 模型支持最多 14 张参考图。
自动检测环境变量，或通过 CLI 初始化。凭据加密存储，零配置即用。
自动处理 API 限流、安全过滤、文件校验。提供清晰的错误恢复指引。
REFERENCE
从文字描述生成商业级产品图片
| 命令 | 说明 | 示例 |
|---|---|---|
hero | 产品主图 (1:1, 白底) | ./nanobanana generate "皮具手提包" --template hero |
banner | 营销 Banner (16:9) | ./nanobanana generate "夏季护肤品" --template banner |
detail | 细节材质图 (3:4) | ./nanobanana generate "机械键盘轴体特写" --template detail |
lifestyle | 生活场景图 (4:3) | ./nanobanana generate "极简书桌布置" --template lifestyle |
grid | 详情页四宫格 (1:1) | ./nanobanana generate "无线耳机" --template grid |
social | 社媒图片 (4:5) | ./nanobanana generate "有机茶叶包装" --template social |
对已有图片进行 AI 增强、替换、变换
| 命令 | 说明 | 示例 |
|---|---|---|
bg-white | 白底电商背景 | ./nanobanana refine product.jpg --template bg-white |
bg-replace | 场景替换 | ./nanobanana refine product.jpg "大理石桌面" --template bg-replace |
bg-remove | 绿幕抠图 | ./nanobanana refine product.jpg --template bg-remove |
enhance | 画质增强 | ./nanobanana refine photo.jpg --template enhance --size 4K |
retouch | 人像修图 | ./nanobanana refine portrait.jpg --template retouch |
style-transfer | 风格迁移 | ./nanobanana refine photo.jpg "浮世绘风格" --template style-transfer |
API Key 管理与状态检查
| 命令 | 说明 | 示例 |
|---|---|---|
init | 初始化 API Key | ./nanobanana auth init --api-key "AIza..." |
status | 查看认证状态 | ./nanobanana auth status |
clean | 清除凭据 | ./nanobanana auth clean |
前往 Google AI Studio，创建 API Key（以 AIza 开头）。
直接告诉 Agent 你的 API Key，或通过环境变量设置：
# 方式一：CLI 初始化（推荐）
./nanobanana auth init --api-key "AIza..."
# 方式二：环境变量（免初始化）
export GEMINI_API_KEY="AIza..."初始化成功后，凭据自动持久化到 ~/.nanobanana/credentials.json。
对 Agent 说"帮我生一张手提包的商品主图"：
./nanobanana generate "luxury brown leather handbag, Italian calfskin" --template hero输出 2K 白底产品主图，适合直接上架。
"做一个夏季促销的横幅 Banner"：
./nanobanana generate "summer skincare collection, fresh and vibrant" --template banner"把这张产品图换成白色背景"：
./nanobanana refine product.jpg --template bg-white需要最高画质时，指定 Pro 模型：
./nanobanana generate "minimalist watch" --template hero --size 4K --model nano-banana-pro| 模型 | 别名 | 最大分辨率 | 适用场景 |
|---|---|---|---|
| Gemini 2.5 Flash Image | Nano Banana | 1024px | 快速预览 |
| Gemini 3.1 Flash Image | Nano Banana 2 | 2K | 默认，速度与质量平衡 |
| Gemini 3 Pro Image | Nano Banana Pro | 4K | 影棚级画质 |
image-studio/
├── nanobanana ← Bash CLI 入口
├── SKILL.md ← Agent 指令文件
├── scripts/
│ ├── nanobanana_api.py ← 核心引擎 (Google Gemini API 客户端)
│ ├── auth.py ← 凭据管理 (init / status / clean)
│ ├── generate.py ← 电商生图 (6 种模板)
│ └── refine.py ← 图像精修 (9 种模板)
└── references/
└── api_reference.md ← API 参数参考INSTALL