| name | nanobanana-draw |
| description | 使用 Nanobanana (Gemini 3 Pro Image) 生成图片,支持中英文描述、图片参考和风格迁移。 |
| allowed-tools | Bash(python:*), Read, Write |
Nanobanana 画图工具
通过 OpenRouter API 调用 Nanobanana (Google Gemini 3 Pro Image) 模型生成图片。支持纯文字描述、图片参考和风格迁移。
快速开始
环境配置
设置 OpenRouter API key:
export OPENROUTER_API_KEY="sk-or-..."
或创建 .env 文件(放在 skill 根目录):
OPENROUTER_API_KEY=sk-or-...
NANOBANANA_MODEL=google/gemini-3-pro-image-preview
OPENROUTER_SITE_URL=https://your-site.example
OPENROUTER_APP_NAME=nanobanana-draw
基础使用(纯文字)
cd .claude/skills/nanobanana-draw
uv run python scripts/nanobanana_draw.py "画一只可爱的橘猫,坐在阳光下"
图片参考(单张图片+描述)
uv run python scripts/nanobanana_draw.py \
"将这张照片中的人物转换成3D卡通风格" \
--image photo.jpg
风格迁移(照片+风格参考图)
uv run python scripts/nanobanana_draw.py \
"将第一张图片的人物转换成第二张图片的风格" \
--image user_photo.jpg \
--style-image cartoon_style.png
多图片参考
uv run python scripts/nanobanana_draw.py \
"融合这两张图片的元素创作新图" \
--image image1.jpg \
--image image2.jpg
添加系统提示词
uv run python scripts/nanobanana_draw.py \
--system "你是专业的插画师,擅长创作细节丰富的插画" \
"画一只在森林里探险的小狐狸"
工作流建议
当用户请求画图时,遵循以下流程:
Step 1: 理解画图需求
与用户确认:
- 画面主题和内容
- 风格偏好(写实/卡通/赛博朋克/水彩等)
- 特殊要求(色调/构图/细节等)
Step 2: 组织 Prompt
基于用户需求构建详细的画图 prompt:
- 主体描述清晰
- 风格明确
- 氛围和细节丰富
- 使用中文或英文均可
Step 3: 调用脚本
cd .claude/skills/nanobanana-draw
python scripts/nanobanana_draw.py "你的画图描述"
Step 4: 返回结果
输出 Nanobanana 生成的图片描述或链接,并根据用户反馈进行调整。
输出格式
- 默认:仅输出模型回复(图片链接或描述)
--print-json:输出完整 JSON
--output result.json:保存完整响应到文件
依赖安装
cd .claude/skills/nanobanana-draw
pip install -r scripts/requirements.txt
在 Claude Code 中使用
在 Claude Code 中直接说:
画一只可爱的柴犬
画一幅赛博朋克风格的城市
帮我画一张产品设计图
Claude 会自动调用该 skill 为你生成图片。
常见提示词模板
角色/人物
画一个可爱的动漫女孩,长发飘逸,穿着校服,在樱花树下微笑
场景/风景
画一幅日落时分的海边,温暖的橘色天空倒映在平静的海面上
概念/设计
画一个未来科技感的智能手表界面设计,简约现代风格
抽象/艺术
画一幅抽象派风格的作品,用蓝色和金色表达宁静与希望的主题
命令行参数
| 参数 | 说明 |
|---|
prompt | 图片生成描述(必填) |
--image, -i | 参考图片路径或URL(可多次使用) |
--style-image, -s | 风格参考图片路径或URL |
--system | 系统提示词 |
--model | 模型ID |
--temperature | 采样温度(默认0.7) |
--max-tokens | 最大token数 |
--save-dir | 图片保存目录 |
--no-save | 不自动保存图片 |
--print-json | 输出完整JSON |
--output | 保存JSON到文件 |
IP形象生成(配合 video-creator 使用)
生成3D卡通风格的数字人IP形象:
方式一:照片+风格图
uv run python scripts/nanobanana_draw.py \
"将第一张图片中的人物转换成第二张图片的3D卡通风格,保持人物特征,正面半身像" \
--image my_photo.jpg \
--style-image cartoon_reference.png \
--save-dir output/ip-avatar
方式二:照片+文字描述
uv run python scripts/nanobanana_draw.py \
"将这张照片中的人物转换成3D皮克斯风格的卡通形象,大眼睛,精致五官,穿着米白色卫衣,戴透明眼镜,深蓝色科技感背景" \
--image my_photo.jpg \
--save-dir output/ip-avatar
技术细节
- 默认模型:
google/gemini-3-pro-image-preview
- 支持通过
--model 参数切换模型
- Temperature 默认 0.7,可通过
--temperature 调整
- 支持
--max-tokens 限制输出长度
- 图片会自动转换为 base64 发送给 API
- 支持本地文件路径和 HTTP/HTTPS URL
故障排查
如果遇到问题:
- 确认 OPENROUTER_API_KEY 已正确设置
- 检查网络连接
- 确认 API key 有效且有足够额度
- 图片文件路径是否正确
- 图片格式是否为 PNG/JPG/JPEG
- 查看错误信息中的详细提示