MCP 服務與 CLI

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 幫你生成。

  1. 01

    加入 MCP 服務

    一行指令就能把 Nano Banana 加進 Claude Code;Cursor 與 Codex 只需加一段設定。

    claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp
  2. 02

    登入

    瀏覽器會自動開啟,按「允許」後 CLI 會把權杖存在本機。

    npx -y @nanobananana/cli@latest auth login
  3. 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 權杖
分享這個頁面