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 | 伺服器錯誤 | 重試或簡化提示詞 |