Nano Banana MCP & CLI
在 Claude Code、Cursor、Codex 中直接用 Nano Banana Pro、Seedream、GPT Image、Seedance 等模型生成圖片與影片。agent 使用的就是你現有的點數與方案。
一步完成設定
- Claude Code
- Cursor
- Codex
把這段話貼給你的 agent,它會幫你完成安裝與登入。
想自己手動設定? 查看接入方式
不需另外的 API 計費,直接使用你現有的 Nano Banana 帳戶。
接入你的 agent
選擇你的用戶端。本機 MCP 透過 npx 執行並沿用 CLI 登入狀態;遠端 MCP 需在 Authorization 標頭帶上 API 權杖。
在終端機執行
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp第一次呼叫工具前,先執行 npx -y @nanobananana/cli@latest auth login 登入,或設定 NANOBANANANA_TOKEN。
三步驟上手
安裝一次、在瀏覽器登入,然後請 agent 幫你生成。
- 01
加入 MCP 服務
一行指令就能把 Nano Banana 加進 Claude Code;Cursor 與 Codex 只需加一段設定。
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp - 02
登入
瀏覽器會自動開啟,按「允許」後 CLI 會把權杖存在本機。
npx -y @nanobananana/cli@latest auth login - 03
開始生成
請 agent 生成圖片或影片,或自己執行 CLI,結果直接下載到專案中。
nanobanana generate create nano-banana-pro --prompt "a banana astronaut" --wait
agent 可用的工具
9 個精簡工具涵蓋從挑選模型到下載結果的完整流程。
nano_account_status電子郵件、方案、點數餘額、哪些模型對你無限,以及今天還剩多少張無限額度。
nano_list_models圖片與影片模型清單,附一句說明與起始價格,可依類型篩選。
nano_get_model模型的所有參數:類型、可選值、範圍,以及哪些選項可以搭配。
nano_estimate_cost依參數回傳準確的點數消耗;組合不合法時說明原因。
nano_upload_image從 HTTPS 連結上傳參考圖;本機 MCP 也支援本機檔案。
nano_generate_image送出生圖任務,回傳請求 ID 與本次扣除的點數。
nano_generate_video送出影片生成任務,參數與網頁一致。
nano_get_generation查詢任務進度,最多等待 20 秒,完成後回傳結果連結。
nano_list_generations分頁查看最近的生成紀錄。
偏好終端機?
所有功能也能直接用指令完成。每個指令都支援 --json,方便接入腳本與 CI。
nanobanana model list --type text_to_image
nanobanana model get nano-banana-pro
nanobanana generate cost nano-banana-pro --prompt "a cozy reading nook" --resolution 2K
nanobanana generate create nano-banana-pro --prompt "a cozy reading nook" --resolution 2K --wait --out ./out
nanobanana generate create seedance --prompt "waves at sunset" --image ./frame.png --wait
nanobanana generate list --limit 20 --json計費方式
agent 使用的是你的 Nano Banana 帳戶,而不是獨立的 API 餘額。
和網頁一樣扣點數
每次生成按 nanobananana.com 上相同的價格扣除帳戶點數,生成失敗會退回點數。
無限依然無限
Plus 與 Ultra 用戶在 Z Image、FLUX.2 上照常無限;透過權杖呼叫每天最多 300 張,避免腳本失控。
先估價再生成
agent 可在生成前呼叫 nano_estimate_cost 估價,且必須明確選擇解析度,不會替你挑更貴的檔位。
點數不夠用? 查看方案與點數包
常見問題
把 Nano Banana 帶進你的 agent
建立權杖、貼上設定,就能在編輯器中開始生成。
建立 API 權杖