nanobanana-skill

Nanobanana Image Skill

使用随附的 nanobanana.py，通过 Gemini 图像模型生成或编辑图像。默认使用 Nano Banana 2（gemini-3.1-flash-image-preview），并启用思考摘要和 Google Search grounding，因为这些默认设置正是使用此技能而非通用图像提示词的主要原因。

要求

1. 在 ~/.nanobanana.env 中设置 GEMINI_API_KEY（GEMINI_API_KEY=sk-dummy），或在 shell 环境中设置。
2. 安装 requirements.txt 中的 Python 依赖项。
3. 可执行文件是此技能目录中的 nanobanana.py。运行前先解析一次它的绝对路径。

即使没有凭据，CLI 也可以输出 --help。它会在创建 API 客户端之前验证本地输入文件；如果 API 未返回图像，则以非零状态码退出。

默认设置

模型为 gemini-3.1-flash-image-preview，启用搜索 grounding，启用 high 级别的思考摘要，分辨率为 1K；除非请求暗示了特定形状，否则不设置宽高比。除非用户要求控制这些选项，否则不要让用户选择模型、搜索模式或思考模式。

对于编辑任务，通常最好不指定宽高比，因为 Gemini 可以匹配输入图像的形状。对于纯文本生成，只有在用户暗示了海报、方形帖子、横幅、手机壁纸或超宽主视觉等格式时才设置宽高比。

值得覆盖的选项：对于细节非常丰富或对排版敏感的作品，使用 --model gemini-3-pro-image-preview（速度较慢）；快速构思时使用 --resolution 512px（仅限 Nanobanana 2 模型），精修成品使用 2K/4K；当响应延迟比精细度更重要时，使用 --thinking-level low；用户想要纯想象内容时关闭搜索。运行 python3 /absolute/path/to/nanobanana.py --help，查看准确的可用值，包括完整的宽高比和模型列表。

运行

根据文本生成：

python3 /absolute/path/to/nanobanana.py \
  --prompt "Create a high-end coffee bag package design with tactile paper texture and clear typography" \
  --output /absolute/path/to/output/package.png

编辑或合成——使用 --input 传入每个参考素材。Nanobanana 2 擅长混合多个参考素材，因此不要将混合、阵容、分镜或一致性处理缩减为单张图像：

python3 /absolute/path/to/nanobanana.py \
  --prompt "Turn these product photos into a clean ecommerce hero image with a soft studio shadow and subtle headline area" \
  --input /absolute/path/to/ref1.png /absolute/path/to/ref2.png \
  --aspect-ratio 4:5 \
  --output /absolute/path/to/output/hero.png

生成有 grounding 的图像，并将模型文本和元数据与图像一同保存：

python3 /absolute/path/to/nanobanana.py \
  --prompt "Use Google Search to ground an editorial illustration about the most recent lunar mission and create a clean magazine cover concept" \
  --text-output /absolute/path/to/output/cover.txt \
  --metadata-output /absolute/path/to/output/cover.json \
  --output /absolute/path/to/output/cover.png

然后报告已保存的路径、搜索 grounding 是否保持启用、文本或思考摘要保存的位置，以及运行过程中出现的任何警告。如果模型返回了文本但没有图像，请明确说明，并建议使用更明确地聚焦图像的提示词，而不要将此次运行说成成功。

编写提示词

好的 Nanobanana 提示词是制作简报，而不是艺术愿望：包括主体、视觉风格、构图或相机取景、任何必需文本、输出用途，以及品牌颜色、留白或真实感等级等限制。

Create a premium sparkling water can advertisement. Use a cold studio product-photo look, silver highlights, condensation droplets, and a clean dark-teal background. Leave negative space in the upper-right for headline copy.

编辑时，既要说明要保留什么，也要说明要更改什么：

Keep the shoe silhouette and logo placement intact. Replace the background with a bright outdoor basketball court, add dynamic afternoon shadows, and keep the image looking like a real sports campaign photo.

运行失败时

检查凭据是否存在，但不要打印其值；检查输入是否可读、输出是否可写。遇到不受支持的选项时，请查阅此工具接受的值。对于助手自行选择的选项，可在符合请求结果的前提下修正；但不要擅自切换用户选择的模型或提供商。进行有限次数的重试前，先检查之前的尝试是否已生成输出；如果恢复需要新的授权或更改请求，则报告实际错误。