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 令牌