NanoPhoto.AI文档Nano Banana 2
通过 OpenClaw 使用 NanoPhoto.AI Nano Banana 2 API 进行图片生成，支持 Google 搜索增强。
通过 NanoPhoto.AI Nano Banana 2 API 生成或编辑图片，支持可选的 Google 搜索提示词增强。
安装：npx clawhub@latest install nano-banana-2
ClawHub：clawhub.ai/u/nanophotohq
前置条件
- 在 nanophoto.ai/settings/apikeys 获取 API Key
- 在 OpenClaw 技能设置中配置
NANOPHOTO_API_KEY
{
"skills": {
"entries": {
"nano-banana-2": {
"enabled": true,
"env": {
"NANOPHOTO_API_KEY": "your_api_key_here"
}
}
}
}
}模式
- generate — 文生图
- edit — 图生图编辑（需要公开图片 URL，最多 14 个）
参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
prompt | string | 是 | 图片生成提示词 |
mode | string | 是 | generate 或 edit |
aspectRatio | string | 否 | 16:9、9:16、4:3 或 3:4 |
imageQuality | string | 否 | 1K（默认）、2K 或 4K |
googleSearch | boolean | 否 | 启用 Google 搜索提示词增强 |
inputImageUrls | string[] | 条件必填 | edit 模式时必填（最多 14 个 URL） |
使用方法
文生图
python3 scripts/nano_banana_2.py submit \
--prompt "未来城市日落，飞行汽车" \
--mode generate \
--aspect-ratio 16:9 \
--image-quality 2K使用 Google 搜索增强
python3 scripts/nano_banana_2.py submit \
--prompt "最新款特斯拉 Cybertruck 在沙漠中" \
--mode generate \
--aspect-ratio 16:9 \
--image-quality 2K \
--google-search \
--follow图生图
python3 scripts/nano_banana_2.py submit \
--prompt "将这张照片转换为水彩画风格" \
--mode edit \
--input-image-url https://example.com/photo.webp \
--aspect-ratio 16:9 \
--image-quality 1K查询状态
python3 scripts/nano_banana_2.py status --generation-id abc123xyz错误码
| 错误码 | 原因 | 处理方式 |
|---|---|---|
LOGIN_REQUIRED | API Key 无效 | 在 settings/apikeys 验证 |
INSUFFICIENT_CREDITS | 积分不足 | 充值积分 |
INVALID_PROMPT | 缺少提示词 | 提供提示词 |
MISSING_INPUT_IMAGE | 编辑模式缺少图片 | 提供公开图片 URL |
TOO_MANY_IMAGES | 超过 14 张图片 | 减少到 14 张以内 |
GENERATION_FAILED | 服务器错误 | 重试或简化提示词 |