NanoPhoto.AI文档Nano Banana Pro
通过 OpenClaw 使用 NanoPhoto.AI Nano Banana Pro API 进行 AI 图片生成和编辑。
通过 NanoPhoto.AI Nano Banana Pro API 生成或编辑图片。
安装：npx clawhub@latest install nano-banana-pro
ClawHub：clawhub.ai/u/nanophotohq
前置条件
- 在 nanophoto.ai/settings/apikeys 获取 API Key
- 在 OpenClaw 技能设置中配置
NANOPHOTO_API_KEY
{
"skills": {
"entries": {
"nano-banana-pro": {
"enabled": true,
"env": {
"NANOPHOTO_API_KEY": "your_api_key_here"
}
}
}
}
}模式
- generate — 文生图
- edit — 图生图编辑（需要公开图片 URL，最多 8 个）
重要
API 仅接受公开图片 URL，不支持本地文件或 base64 图片。
参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
prompt | string | 是 | 图片生成提示词 |
mode | string | 是 | generate 或 edit |
aspectRatio | string | 否 | 16:9、9:16、4:3 或 3:4 |
imageQuality | string | 否 | 1K（默认）、2K 或 4K |
inputImageUrls | string[] | 条件必填 | edit 模式时必填（最多 8 个 URL） |
使用方法
文生图
python3 scripts/nano_banana_generate.py \
--prompt "未来城市日落，飞行汽车和霓虹灯" \
--mode generate \
--aspect-ratio 16:9 \
--image-quality 2K图生图
python3 scripts/nano_banana_generate.py \
--prompt "将这张照片转换为水彩画风格" \
--mode edit \
--input-image-url https://example.com/photo.webp \
--aspect-ratio 16:9 \
--image-quality 1K脚本会从环境变量读取 NANOPHOTO_API_KEY，提交任务，自动轮询，并输出最终 JSON 结果。
错误码
| 错误码 | 原因 | 处理方式 |
|---|---|---|
LOGIN_REQUIRED | API Key 无效 | 在 settings/apikeys 验证 |
INSUFFICIENT_CREDITS | 积分不足 | 充值积分 |
INVALID_PROMPT | 缺少提示词 | 提供提示词 |
MISSING_INPUT_IMAGE | 编辑模式缺少图片 | 提供公开图片 URL |
TOO_MANY_IMAGES | 超过 8 张图片 | 减少到 8 张以内 |
GENERATION_FAILED | 服务器错误 | 重试或简化提示词 |