Nano Banana Image Creator

使用 Nano Banana Pro API 通过文本提示生成或编辑图像，支持从草稿到 1K/2K/4K 高分辨率输出及图像编辑。

已扫描

项目

内容

适合谁

设计师、内容创作者

不适合谁

无网络环境用户、无需图像处理的普通办公人员

国内可用性

需网络配置。可能需要网络配置或第三方服务可访问。

安装难度

新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

复制命令安装

openclaw skills install @namebekc/my-nano-image

官方 ZIP下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Nano Banana Pro 图像生成与编辑

使用 Google 的 Nano Banana Pro API（Gemini 3 Pro Image）生成新图像或编辑现有图像。

使用方法

请使用绝对路径运行脚本（不要先进入技能目录）：

生成新图像：

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "你的图像描述" --filename "输出文件名.png" [--resolution 1K|2K|4K] [--api-key KEY]

编辑现有图像：

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "编辑指令" --filename "输出文件名.png" --input-image "输入图像路径.png" [--resolution 1K|2K|4K] [--api-key KEY]

重要提示： 始终从当前工作目录运行，以确保图像保存在用户所在位置，而非技能目录中。

默认工作流程（草稿 → 迭代 → 最终版）

目标：快速迭代，避免在提示不准确时过早使用 4K 分辨率。

草稿（1K）： 快速反馈循环

- uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<草稿提示>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K

迭代： 逐步微调提示；每次运行使用新的文件名。

- 若为编辑任务：在满意前保持相同的 --input-image。

最终版（4K）： 仅当提示确定后使用

- uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<最终提示>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K

分辨率选项

Gemini 3 Pro Image API 支持三种分辨率（必须大写 K）：

1K（默认） - 约 1024px 分辨率
2K - 约 2048px 分辨率
4K - 约 4096px 分辨率

将用户请求映射为 API 参数：

未提及分辨率 → 1K
“低分辨率”、“1080”、“1080p”、“1K” → 1K
“2K”、“2048”、“正常”、“中等分辨率” → 2K
“高分辨率”、“高画质”、“高清”、“4K”、“超清” → 4K

API 密钥

脚本按以下顺序检查 API 密钥：

--api-key 参数（用户在聊天中提供时使用）
GEMINI_API_KEY 环境变量

若两者均未提供，脚本将退出并显示错误信息。

预检与常见问题（快速解决）

预检检查：

- command -v uv（必须存在）

- test -n "$GEMINI_API_KEY"（或提供 --api-key）

- 若为编辑任务：test -f "path/to/input.png"

常见错误：

- Error: No API key provided. → 设置 GEMINI_API_KEY 或提供 --api-key

- Error loading input image: → 路径错误或文件不可读；确认 --input-image 指向真实图像

- “quota/permission/403” 类型的 API 错误 → 密钥错误、无权限或配额超限；尝试更换密钥或账户

文件名生成

使用格式：yyyy-mm-dd-hh-mm-ss-名称.png

格式： {时间戳}-{描述性名称}.png

时间戳：当前日期时间，格式为 yyyy-mm-dd-hh-mm-ss（24小时制）
名称：小写描述性文本，用连字符分隔
描述部分应简洁（通常 1-5 个词）
根据用户提示或对话上下文选择名称
若上下文不清，使用随机标识符（如 x9k2、a7b3）

示例：

提示：“一个宁静的日式庭院” → 2025-11-23-14-23-05-japanese-garden.png
提示：“山间的日落” → 2025-11-23-15-30-12-sunset-mountains.png
提示：“创建一个机器人的图像” → 2025-11-23-16-45-33-robot.png
上下文不明确 → 2025-11-23-17-12-48-x9k2.png

图像编辑

当用户希望修改现有图像时：

检查是否提供了图像路径，或引用了当前目录中的图像
使用 --input-image 参数指定图像路径
提示中包含编辑指令（如“让天空更戏剧化”、“移除人物”、“改为卡通风格”）
常见编辑任务：添加/移除元素、改变风格、调整色彩、模糊背景等

提示处理

生成任务： 将用户的图像描述原样传递给 --prompt。仅在明显不充分时才进行重写。

编辑任务： 将编辑指令放入 --prompt（如“在天空中添加一道彩虹”、“让它看起来像水彩画”）

始终保留用户的创作意图。

提示模板（高成功率）

当用户表述模糊或需精确编辑时使用模板。

生成模板：

- “创建一张： <主体>。风格： <风格>。构图： <镜头/拍摄角度>。光照： <光照效果>。背景： <背景>。配色方案： <配色>。避免： <列表>。”

编辑模板（仅更改指定内容）：

- “仅更改： <单一修改项>。其余保持不变：主体、构图/裁剪、姿态、光照、配色方案、背景、文字及整体风格。不要添加新物体。如有文字，请保持不变。”

输出结果

保存 PNG 文件至当前目录（或文件名中指定的路径）
脚本输出生成图像的完整路径
不要读取图像内容 —— 仅告知用户文件保存路径即可

示例