Banana Image - AI 图片生成
基于 Gemini API 的独立图片生成技能，支持 4K 输出、双模型选择、图片编辑。
环境要求
设置 API Key（必需）
export GEMINI_API_KEY="your-api-key"
安装依赖（首次使用）
cd .claude/skills/banana-image/scripts && npm install
快速命令
快速生成（Flash 模型）
npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts
-p "可爱的柴犬在公园玩耍" -m flash
4K 高质量生成（Pro 模型）
npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts
-p "专业产品照片：iPhone 手机壳" -m pro -r 4K -a 4:5
模型选择
模型 速度 分辨率 适用场景
Flash 2-3s ≤1024px 快速草图、迭代、原型
Pro 5-8s ≤4K 最终交付、营销素材、专业作品
自动选择规则：
-
包含 "快速"、"草图"、"draft" → Flash
-
包含 "4K"、"专业"、"高质量" → Pro（默认）
参数说明
npx tsx banana_image_exec.ts --help
Options: --prompt, -p <text> 图片描述（必需） --model, -m <type> 模型选择: flash | pro (默认: pro) --aspect-ratio, -a <r> 宽高比: 1:1, 16:9, 9:16, 4:3, 3:2, 21:9 等 --resolution, -r <res> 分辨率: 1K, 2K, 4K (默认: Pro=4K, Flash=1K) --negative, -n <text> 排除内容描述 --output, -o <dir> 输出目录 (默认: ./images) --grounding, -g 启用 Google Search 锚定 (仅 Pro) --input, -i <path> 输入图片路径（编辑模式） --system, -s <text> 系统指令 --count, -c <num> 生成数量 (1-4)
工作流
- 简单生成
npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts
-p "A cute shiba inu playing in the park"
-m pro
- 带参数生成
16:9 横版海报，启用 Google 搜索锚定
npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts
-p "2024年科技大会宣传海报"
-m pro -r 4K -a 16:9 -g
- 图片编辑
修改现有图片
npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts
-p "将背景改为黄昏海滩"
-i /path/to/original.png
- 批量生成
生成多张变体
npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts
-p "产品照片：无线耳机"
-m pro -c 4
输出格式
脚本输出 JSON 格式结果：
{ "success": true, "images": [ { "path": "./images/banana_pro_2024-01-01T12-00-00_abc123.png", "model": "gemini-3-pro-image-preview", "prompt": "可爱的柴犬" } ], "metadata": { "model": "gemini-3-pro-image-preview", "aspectRatio": "1:1", "resolution": "4K", "duration": 5234 } }
宽高比映射
用途 宽高比 关键词
社交媒体方图 1:1 "方形"、"Instagram"
横版海报 16:9 "横版"、"YouTube"、"桌面壁纸"
竖版海报 9:16 "竖版"、"手机壁纸"、"Story"
产品图 4:5 "产品"、"电商"
电影海报 2:3 "海报"、"电影"
超宽屏 21:9 "超宽"、"Banner"
模板系统
读取预定义模板生成图片：
列出可用模板
python .claude/skills/banana-image/scripts/apply_template.py list
应用产品图模板
python .claude/skills/banana-image/scripts/apply_template.py apply product
-v '{"product": "wireless earbuds"}'
模板输出可直接传递给 banana_image_exec.ts 。
错误处理
错误 原因 解决方案
GEMINI_API_KEY not set 未设置 API Key export GEMINI_API_KEY="..."
Content filtered 内容安全过滤 调整描述，避免敏感词
Invalid aspect ratio 不支持的宽高比 使用支持的宽高比
Image generation failed API 调用失败 检查网络和 API 配额
参考文档
- 高级用法 - 批量生成、图片编辑、参数优化