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 令牌
分享这个页面