nano-banana 是一个 AI 图像生成命令行工具，默认模型为 Gemini 3.1 Flash Image Preview（Nano Banana 2），同时提供 Gemini 3 Pro 选项。
用途 该工具用于在终端中通过文本提示词生成图像，适合快速产出落地页素材、产品模型图、UI 预览、营销配图、游戏素材、视频视觉元素等。
主要能力
- 多分辨率：支持 512、1K、2K、4K 四档尺寸。
- 宽高比：支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3、4:5、5:4、21:9。
- 模型选择：flash/nb2 为默认快速模型，pro/nb-pro 为高质量模型，也可传入任意模型 ID。
- 参考图：通过 -r 可多次指定参考图，用于图像编辑、风格迁移或组合多种风格。
- 透明背景：使用 -t 标志自动提示 AI 在绿幕上生成，再用 FFmpeg colorkey 与 despill 去除背景及绿色边缘溢出，生成像素级透明素材。
- 精确尺寸：可将第一张参考图作为风格来源，最后一张参考图设为目标尺寸的空白图，并在提示词中写明尺寸。
- 成本追踪：每次生成记录到 ~/.nano-banana/costs.json，使用 nano-banana --costs 查看汇总。
使用方式 安装（无需 sudo）：
- 安装 Bun：curl -fsSL https://bun.sh/install | bash
- 克隆仓库：git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2
- 安装依赖：cd ~/tools/nano-banana-2 && bun install
- 全局链接：cd ~/tools/nano-banana-2 && bun link
- 配置 API Key：mkdir -p ~/.nano-banana && echo "GEMINI_API_KEY=" > ~/.nano-banana/.env 若 bun link 失败或命令未找到，可改用符号链接方式： mkdir -p ~/.local/bin ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc API Key 获取地址：https://aistudio.google.com/apikey
基本命令：nano-banana "prompt" [options] 默认输出为 1K 分辨率、Flash 模型、当前目录。 常用选项：
- -o, --output：输出文件名（不含扩展名），默认 nano-gen-{timestamp}
- -s, --size：图像尺寸，512、1K、2K 或 4K，默认 1K
- -a, --aspect：宽高比，默认由模型决定
- -m, --model：模型，flash/nb2、pro/nb-pro 或任意模型 ID，默认 flash
- -d, --dir：输出目录，默认当前目录
- -r, --ref：参考图，可多次使用
- -t, --transparent：绿幕生成并去背景（需 FFmpeg）
- --api-key：Gemini API Key，覆盖环境变量与文件配置
- --costs：显示成本汇总
API Key 解析顺序：--api-key 参数、GEMINI_API_KEY 环境变量、当前目录 .env、CLI 脚本旁的 .env、~/.nano-banana/.env。
适用场景
- 落地页素材：产品模型图、UI 预览
- 图像编辑：用提示词转换已有图像
- 风格迁移：组合多张参考图
- 营销物料：主视觉图、功能插图
- UI 迭代：快速生成设计变体
- 透明素材：图标、Logo、吉祥物
- 游戏素材：精灵图、背景、角色
- 视频制作：视频合成用视觉元素
限制与费用
- 透明背景功能需安装 FFmpeg 与 ImageMagick：brew install ffmpeg imagemagick
- 生成按尺寸与模型计费：Flash 512 约 $0.045、1K 约 $0.067、2K 约 $0.101、4K 约 $0.151；Pro 1K 约 $0.134、2K 约 $0.201、4K 约 $0.302，512 仅 Flash 支持。
- 参考图顺序影响结果：第一张为主要风格/内容来源，后续为次要影响，最后一张可控制输出尺寸。
- 其他平台支持情况、更多模型细节与官方文档暂未提供。