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 金鑰、檢視用量和餘額