Nano Banana Pro 图像生成与编辑

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

使用方法

使用绝对路径运行脚本（请勿先 cd 到技能目录）：

生成新图像：

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 密钥：

1. --api-key 参数（如果用户在聊天中提供了密钥，则使用此选项）
2. GEMINI_API_KEY 环境变量

如果两者均不可用，脚本将退出并显示错误消息。

预检 + 常见故障（快速修复）

• 预检：
  • command -v uv（必须存在）
  • test -n \"$GEMINI_API_KEY\"（或传递 --api-key）
  • 如果编辑：test -f \"输入图像路径.png\"
• 常见故障：
  • Error: No API key provided. → 设置 GEMINI_API_KEY 或传递 --api-key
  • Error loading input image: → 路径错误/文件不可读；验证 --input-image 指向真实图像
  • “配额/权限/403”等 API 错误 → 密钥错误、无权限或超出配额；尝试使用其他密钥/账户

文件名生成

按照以下模式生成文件名：yyyy-mm-dd-hh-mm-ss-name.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

图像编辑

当用户想要修改现有图像时：

1. 检查他们是否提供了图像路径或引用了当前目录中的图像
2. 使用 --input-image 参数，值为图像路径
3. 提示词应包含编辑说明（例如，“使天空更加戏剧化”、“移除人物”、“改为卡通风格”）
4. 常见编辑任务：添加/移除元素、改变风格、调整颜色、背景模糊等。

提示词处理

对于生成： 按原样将用户的图像描述传递给 --prompt。仅在明显不足时重新加工。

对于编辑： 在 --prompt 中传递编辑说明（例如，“在天空中加一道彩虹”、“让它看起来像水彩画”）

在这两种情况下，都要保留用户的创作意图。

提示词模板（高成功率）

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

• 生成模板：
  • “创建图像：<主题>。风格：<风格>。构图：<相机/镜头>。光线：<光线>。背景：<背景>。色调：<调色板>。避免：<列表>。”
• 编辑模板（保留其他所有内容）：
  • “仅更改：<单项更改>。保持相同：主题、构图/裁剪、姿势、光线、调色板、背景、文字和整体风格。不要添加新对象。如果存在文字，保持原样。”

输出

• 将 PNG 保存到当前目录（如果文件名包含目录，则保存到指定路径）
• 脚本输出生成图像的完整路径
• 不要将图像读回 – 只需告知用户保存的路径

示例

生成新图像：

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "一个宁静的日本花园，有樱花" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K

编辑现有图像：

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "用风暴云使天空更加戏剧化" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K