nano-banana-pro

用途

nano-banana-pro 用于调用 Google 的 Nano Banana Pro API（Gemini 3 Pro Image）生成新图像或编辑已有图像，适用于图像创建与修改类请求，包括文生图和以图生图。

主要能力

文生图：根据文字描述生成图像。
以图生图 / 图像编辑：通过 --input-image 传入已有图像，并按提示词中的编辑指令进行修改，常见任务包括添加/移除元素、改变风格、调整颜色、模糊背景等。
分辨率支持：API 支持 1K（默认，约 1024px）、2K（约 2048px）、4K（约 4096px）三档，注意需使用大写 K。
提示词优化：提供 optimize_prompt.py 脚本，支持 photo、illustration、anime、oil-painting、3d、pixel、cinematic、watercolor 等风格。
双服务商：主服务商为 xingjiabiapi / Google Gemini，备用为菠萝包（Boluobao）；主服务商失败（配额/403/超时）时自动切换。

使用方式

使用绝对路径运行脚本，不要先 cd 到技能目录，始终在用户当前工作目录下运行。

第一步：优化提示词（必需）

第二步：使用优化后的提示词生成

uv run ~/.openclaw/agents/content/agent/skills/nano-banana-pro/scripts/generate_image_boluobao.py
--prompt "$OPTIMIZED" --filename "output.png" [--resolution 1k|2k|4k] [--aspect-ratio 16:9]

或使用 xingjiabiapi（主服务商）：

uv run ~/.openclaw/agents/content/agent/skills/nano-banana-pro/scripts/generate_image.py
--prompt "$OPTIMIZED" --filename "output.png" [--resolution 1K|2K|4K] [--api-key KEY]

编辑已有图像（跳过优化器）：

uv run ~/.openclaw/agents/content/agent/skills/nano-banana-pro/scripts/generate_image.py
--prompt "editing instructions" --filename "output.png" --input-image "path/to/input.png"

默认工作流为：优化 → 草稿（1K）→ 迭代 → 最终（4K）。先优化提示词，再用低分辨率快速迭代，满意后再出 4K 成品。

分辨率映射：未提及分辨率 → 1K；"low resolution"、"1080"、"1080p"、"1K" → 1K；"2K"、"2048"、"normal"、"medium resolution" → 2K；"high resolution"、"high-res"、"hi-res"、"4K"、"ultra" → 4K。

API Key：主服务商可通过 --api-key 参数或 GEMINI_API_KEY 环境变量提供；备用菠萝包可通过 --api-key 参数或 BOLUOBAO_API_KEY 环境变量提供，也可使用 pass show api/boluobao。

菠萝包备用脚本特有选项：--aspect-ratio 支持 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9；--input-image 需传入图像 URL（非本地文件），最多 14 张；--model 默认 gemini-3-pro-image-preview。

文件名生成规则：格式为 {timestamp}-{descriptive-name}.png，时间戳为 yyyy-mm-dd-hh-mm-ss（24 小时制），描述部分为小写连字符文本，通常 1-5 个词；上下文不明确时使用随机标识符（如 x9k2、a7b3）。

适用场景

根据文字描述创建图像。
对已有图像进行编辑，如改变风格、调整颜色、增删元素、模糊背景等。
需要按指定分辨率（1K/2K/4K）和宽高比输出图像的场景。

限制与注意事项

运行前需确认 uv 命令存在，并设置好 API Key（或通过 --api-key 传入）；编辑时需确认输入图像路径真实可读。
常见错误：未提供 API Key 会报 "No API key provided."；输入图像加载失败通常是路径错误或文件不可读；"quota/permission/403" 类错误表示密钥错误、无权限或配额超限，需更换密钥/账号。
菠萝包备用脚本的 --input-image 只接受图像 URL，不接受本地文件。
脚本输出生成图像的完整路径，不要回读图像，只需告知用户保存路径。
提示词处理：生成时按原样传入用户描述，仅在明显不足时改写；编辑时在 --prompt 中传入编辑指令，并保留用户创作意图。
提示词模板：生成模板为 "Create an image of: . Style: . Composition: <camera/shot>. Lighting: . Background: . Color palette: . Avoid: ."；编辑模板为 "Change ONLY: . Keep identical: subject, composition/crop, pose, lighting, color palette, background, text, and overall style. Do not add new objects. If text exists, keep it unchanged."
关于收费、价格、平台等具体信息，资料中暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制与注意事项