mcpField
N
nano-banana-pro-openrouter

nano-banana-pro-openrouter

github.com/github创意与媒体40.5k9.9k 次安装今天更新
代码仓库

关于 nano-banana-pro-openrouter

通过 OpenRouter 和 google/gemini-3-pro-image-preview 模型生成或编辑图像的技能,支持文本提示生成、单图修改和多图合成。

主要功能

  1. 01根据提示生成图像
  2. 02编辑单张图像
  3. 03最多合成 3 张输入图像
  4. 04提供 1K、2K 和 4K 分辨率选项
  5. 05可自定义系统提示词

适用场景

  1. 01根据文字描述创建图像
  2. 02按指令修改现有图像
  3. 03将多张图像合成为一张

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/github/awesome-copilot --skill nano-banana-pro-openrouter

安装后在 Claude Code 中输入/nano-banana-pro-openrouter确认已加载。

附带文件assets/SYSTEM_TEMPLATEscripts/generate_image.py

详细介绍

Nano Banana Pro OpenRouter

概述

使用 google/gemini-3-pro-image-preview 模型,通过 OpenRouter 生成或编辑图像。支持仅提示词生成、单图编辑和多图合成。

仅提示词生成
uv run {baseDir}/scripts/generate_image.py \
  --prompt "A cinematic sunset over snow-capped mountains" \
  --filename sunset.png
编辑单张图像
uv run {baseDir}/scripts/generate_image.py \
  --prompt "Replace the sky with a dramatic aurora" \
  --input-image input.jpg \
  --filename aurora.png
合成多张图像
uv run {baseDir}/scripts/generate_image.py \
  --prompt "Combine the subjects into a single studio portrait" \
  --input-image face1.jpg \
  --input-image face2.jpg \
  --filename composite.png

分辨率

  • 将 --resolution 与 1K、2K 或 4K 搭配使用。
  • 未指定时默认为 1K。

系统提示词自定义

该技能从 assets/SYSTEM_TEMPLATE 读取可选的系统提示词。这让你无需修改代码即可自定义图像生成行为。

行为与约束

  • 通过重复使用 --input-image 最多接受 3 张输入图像。
  • --filename 接受相对路径(保存到当前目录)或绝对路径。
  • 如果返回多张图像,则在文件名后追加 -1、-2。
  • 为每张保存的图像打印 MEDIA: <path>。不要将图像读回响应中。

故障排查

如果脚本以非零状态退出,请对照以下常见阻碍检查 stderr:

症状解决方法
OPENROUTER_API_KEY is not set请用户设置它。PowerShell:$env:OPENROUTER_API_KEY = "sk-or-..." / bash:export OPENROUTER_API_KEY="sk-or-..."
uv: command not found 或无法识别macOS/Linux:curl -LsSf https://astral.sh/uv/install.sh | sh。Windows:powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"。然后重启终端。
AuthenticationError / HTTP 401密钥无效或没有额度。请在 https://openrouter.ai/settings/keys 检查。

对于暂时性错误(HTTP 429、网络超时),请在 30 秒后重试一次。同一错误的重试不要超过两次——而应将问题反馈给用户。

评论

支持 Markdown