nano-banana

nano-banana

AI 图像生成命令行工具。默认模型：Gemini 3.1 Flash Image Preview（Nano Banana 2）。

/init - 首次设置

当用户说“init”“setup nano-banana”或“install nano-banana”时，运行以下命令，在其设备上安装命令行工具。无需 sudo。

**前置条件：**必须已安装 Bun。如果尚未安装：curl -fsSL https://bun.sh/install | bash

# 1. Clone the repo
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2

# 2. Install dependencies
cd ~/tools/nano-banana-2 && bun install

# 3. Link globally (creates `nano-banana` command via Bun - no sudo)
cd ~/tools/nano-banana-2 && bun link

# 4. Set up API key
mkdir -p ~/.nano-banana
echo "GEMINI_API_KEY=<ask user for their key>" > ~/.nano-banana/.env

初始化后，用户可以在任意位置输入 nano-banana "prompt"。

如果 bun link 失败，或者链接后找不到命令，请改用：

mkdir -p ~/.local/bin
ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana
# Then ensure ~/.local/bin is on PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

获取 Gemini API 密钥：https://aistudio.google.com/apikey

快速参考

• 命令：nano-banana "prompt" [options]
• 默认值：1K 分辨率、Flash 模型、当前目录

核心选项

选项	默认值	说明
-o, --output	nano-gen-{timestamp}	输出文件名（不含扩展名）
-s, --size	1K	图像尺寸：512、1K、2K 或 4K
-a, --aspect	模型默认值	宽高比：1:1、16:9、9:16、4:3、3:4 等
-m, --model	flash	模型：flash/nb2、pro/nb-pro，或任意模型 ID
-d, --dir	当前目录	输出目录
-r, --ref	-	参考图像（可多次使用）
-t, --transparent	-	在绿幕上生成图像并移除背景（FFmpeg）
--api-key	-	Gemini API 密钥（覆盖环境变量/文件中的值）
--costs	-	显示费用汇总

模型

别名	模型	适用场景
flash、nb2	Gemini 3.1 Flash	默认。快速、便宜（每张 1K 图像约 $0.067）
pro、nb-pro	Gemini 3 Pro	需要最高画质时（每张 1K 图像约 $0.134）

尺寸

尺寸	费用（Flash）	费用（Pro）
512	约 $0.045	仅限 Flash
1K	约 $0.067	约 $0.134
2K	约 $0.101	约 $0.201
4K	约 $0.151	约 $0.302

宽高比

支持：1:1、16:9、9:16、4:3、3:4、3:2、2:3、4:5、5:4、21:9

使用 -a 标志：nano-banana "cinematic scene" -a 16:9

主要工作流

基础生成

nano-banana "minimal dashboard UI with dark theme"
nano-banana "cinematic landscape" -s 2K -a 16:9
nano-banana "quick concept sketch" -s 512

选择模型

# Default (Flash - fast, cheap)
nano-banana "your prompt"

# Pro (highest quality)
nano-banana "detailed portrait" --model pro -s 2K

参考图像（风格迁移/编辑）

# Edit existing image
nano-banana "change the background to pure white" -r dark-ui.png -o light-ui

# Style transfer - multiple references
nano-banana "combine these two styles" -r style1.png -r style2.png -o combined

透明素材

nano-banana "robot mascot character" -t -o mascot
nano-banana "pixel art treasure chest" -t -o chest

-t 标志会自动提示 AI 在绿幕上生成图像，然后使用 FFmpeg colorkey + despill 去除背景色，并清除边缘像素上的绿色溢色。无需手动编写提示词，即可获得像素级精准的透明效果。

需要安装：brew install ffmpeg imagemagick

精确尺寸

要获得特定的输出尺寸：

1. 第一个 -r 标志：你的参考图像/风格图像
2. 最后一个 -r 标志：目标尺寸的空白图像
3. 在提示词中注明尺寸

nano-banana "pixel art character in style of first image, 256x256" -r style.png -r blank-256x256.png -o sprite

参考图像顺序很重要

• 第一张参考图像：主要的风格/内容来源
• 其他参考图像：辅助影响因素
• 最后一张参考图像：控制输出尺寸（使用空白图像技巧时）

费用跟踪

每次生成都会记录到 ~/.nano-banana/costs.json。查看汇总：

nano-banana --costs

使用场景

• 着陆页素材 - 产品模型、UI 预览
• 图像编辑 - 使用提示词转换现有图像
• 风格迁移 - 组合多张参考图像
• 营销材料 - 主视觉图、功能插图
• UI 迭代 - 快速生成设计变体
• 透明素材 - 无背景图标、徽标、吉祥物
• 游戏素材 - 精灵图、背景、角色
• 视频制作 - 用于视频合成的视觉元素

提示词示例

# UI mockups
nano-banana "clean SaaS dashboard with analytics charts, white background"

# Widescreen cinematic
nano-banana "cyberpunk cityscape at sunset" -a 16:9 -s 2K

# Product shots with Pro quality
nano-banana "premium software product hero image" --model pro

# Quick low-res concept
nano-banana "rough sketch of a robot" -s 512

# Dark mode UI
nano-banana "Premium SaaS chat interface, dark mode, minimal, Linear-style aesthetic"

# Game assets with transparency (green screen auto-prompted)
nano-banana "pixel art treasure chest" -t -o chest

# Portrait aspect ratio
nano-banana "mobile app onboarding screen" -a 9:16

API 密钥设置

命令行工具按以下顺序查找 Gemini API 密钥：

1. --api-key 标志
2. GEMINI_API_KEY 环境变量
3. 当前目录中的 .env 文件
4. 命令行脚本旁的 .env 文件
5. ~/.nano-banana/.env

获取密钥：https://aistudio.google.com/apikey