Skip to main content

​
概述

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易 模型

该 Skill 使用 Nano Banana Pro 模型。如果你还需要 Nano Banana 2 的更快速度和更低成本，可以查看 Nano Banana ComfyUI 节点，它同时支持两个模型。

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

1

第一步：获取 API易 密钥

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

第二步：安装 Skill

在终端中运行以下命令安装：
需要 Node.js 环境。如未安装 Node.js，请先访问 nodejs.org 下载安装。Python 可作为备选运行环境。
3

第三步：配置 API 密钥

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

​
实战教程

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

最直接的用法——在终端中输入描述，生成图片。

​
用法二：编辑已有图片

传入一张或多张参考图片，用自然语言描述修改效果。
支持多张参考图（最多 14 张），图片会自动转为 Base64 编码传送：

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

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

​
命令参数详解

​
支持的宽高比

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

​
分辨率与耗时参考

​
常见问题

请检查：
  1. 是否已安装 Node.js（运行 node -v 确认）
  2. 网络连接是否正常
  3. 如果 npx 命令不可用，可以手动克隆仓库：
然后将 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 文档和定价

APIYI GPT-Image 2 Skills（同作者）

wuchubuzai2018 同一 Skills 合集下的 gpt-image-2 / gpt-image-2-all 双 Skill

Nano Banana ComfyUI 节点

在 ComfyUI 中使用 Nano Banana 生图

生图失败排查

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

API易-令牌管理

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