跳转到主要内容

​
概述

nano-banana-pro-image-gen 是一个社区贡献的开源 AI Agent Skill，让你在 Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp 等主流 AI 编程工具中，通过一句自然语言就能生成和编辑图片。底层调用 API易 的 Nano Banana Pro 模型，无需复杂配置，安装即用。
项目信息
  • 🔗 开源地址：github.com/wuchubuzai2018/expert-skills-hub
  • 🌐 Skill 主页：skills.sh/wuchubuzai2018/expert-skills-hub/nano-banana-pro-image-gen
  • 👤 作者：wuchubuzai2018（无处不在的技术）
  • ⭐ 该项目由社区用户贡献

​
为什么用这个 Skill

一句话生图

在 AI 编程助手中直接用自然语言描述，即刻生成高质量图片，无需离开编辑器

图片编辑

支持传入已有图片进行编辑，最多 14 张参考图，实现风格迁移和内容修改

多平台兼容

已适配 Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp 等工具

灵活输出

10 种宽高比 + 3 档分辨率（1K/2K/4K），覆盖从快速预览到高清海报的各种场景

​
支持的 API易 模型

模型名称模型标识用途API文档
Nano Banana Progemini-3-pro-image-preview文生图、图生图查看文档
该 Skill 使用 Nano Banana Pro 模型。如果你还需要 Nano Banana 2 的更快速度和更低成本，可以查看 Nano Banana ComfyUI 节点，它同时支持两个模型。

​
快速上手：3 步开始生图

1

第一步：获取 API易 密钥

  1. 访问 API易控制台 注册/登录
  2. 进入【令牌】栏目，生成新的 API 密钥
  3. 复制密钥（以 sk- 开头）
新用户注册即可获得免费测试额度，足够体验 Nano Banana 图像生成功能。
2

第二步：安装 Skill

在终端中运行以下命令安装：
npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill nano-banana-pro-image-gen
需要 Node.js 环境。如未安装 Node.js，请先访问 nodejs.org 下载安装。Python 可作为备选运行环境。
3

第三步：配置 API 密钥

设置环境变量：
export APIYI_API_KEY="sk-你的API易密钥"
Windows PowerShell 用户：
$env:APIYI_API_KEY="sk-你的API易密钥"
建议将环境变量写入 ~/.zshrc 或 ~/.bashrc，避免每次重新设置。
配置完成！现在你可以在支持 Skills 的 AI 编程工具中直接使用图片生成功能。

​
实战教程

​
用法一：命令行文字生图

最直接的用法——在终端中输入描述，生成图片。 
node scripts/generate_image.js \
  -p "一只宇航员猫咪漂浮在太空中，背景是地球，数字艺术风格" \
  -f "astronaut-cat.png" \
  -a 16:9 \
  -r 2K

​
用法二：编辑已有图片

传入一张或多张参考图片，用自然语言描述修改效果。 
node scripts/generate_image.js \
  -p "把这张照片转换为吉卜力动画风格，保持人物构图不变" \
  -i "photo.jpg" \
  -f "ghibli-style.png" \
  -r 2K
支持多张参考图（最多 14 张），图片会自动转为 Base64 编码传送： 
node scripts/generate_image.js \
  -p "将这些元素融合成一张海报" \
  -i "bg.jpg" -i "logo.png" -i "text.png" \
  -f "poster.png" \
  -a 3:4 \
  -r 4K

​
用法三：在 AI 编程助手中使用

安装 Skill 后，在支持的 AI 编程工具中可以直接用自然语言指令：
  • Codex CLI / OpenCode：“帮我生成一张 16:9 的赛博朋克城市壁纸，4K 分辨率”
  • Cursor：“生成一张产品 logo，简约风格，1:1 比例”
  • Gemini CLI：“编辑 input.jpg，将背景改为夕阳海滩”
AI 助手会自动调用 Skill 完成图片生成。

​
命令参数详解

参数缩写必填说明示例
--prompt-p是图片描述或编辑指令"一只猫咪"
--filename-f否输出文件路径（省略则自动生成）"output.png"
--aspect-ratio-a否宽高比16:9
--resolution-r否分辨率（必须大写）1K、2K、4K
--input-image-i否输入图片路径（可多次指定，最多14张）"photo.jpg"
--key-k否内联 API Key（不推荐，建议用环境变量）"sk-xxx"

​
支持的宽高比

1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9

​
分辨率与耗时参考

分辨率大致耗时适合场景
1K约 30 秒快速预览、测试效果
2K（默认）1-4 分钟日常使用、社交媒体
4K较慢高清海报、印刷品

​
常见问题

请检查：
  1. 是否已安装 Node.js（运行 node -v 确认）
  2. 网络连接是否正常
  3. 如果 npx 命令不可用，可以手动克隆仓库：
git clone https://github.com/wuchubuzai2018/expert-skills-hub.git
然后将 skills/nano-banana-pro-image-gen 目录复制到你的 Skills 目录中。
请确认：
  1. 环境变量 APIYI_API_KEY 已正确设置（以 sk- 开头）
  2. API易 账户余额充足
  3. 也可以使用 -k 参数直接传入密钥测试
分辨率参数必须使用大写：1K、2K、4K。小写 1k、2k 会导致参数无法识别。
  • 4K 分辨率本身需要较长处理时间（可能超过 5 分钟）
  • 建议先用 1K 分辨率调试提示词和构图
  • 确认满意后再用 2K 或 4K 生成最终版本
访问 API易控制台，注册账号后在【令牌】栏目生成新的密钥。新用户有免费测试额度。
目前已适配：Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp。任何支持 Skills 协议的工具都可以使用。

​
相关资源

Nano Banana Pro 文档

查看 Nano Banana Pro 完整 API 文档和定价

Nano Banana ComfyUI 节点

在 ComfyUI 中使用 Nano Banana 生图

生图失败排查

Nano Banana 生图常见问题排查指南

API易-令牌管理

管理 API 密钥、查看用量和余额