面向开发者
Nano Banana Pro MCP 服务
让 AI 助手代您生成图片和视频。在支持 Model Context Protocol 的客户端中添加一个服务地址,在浏览器中登录账号,然后用自然语言描述需求即可。
工作方式
各客户端的设置方法
请选择所用的客户端。不同版本的菜单名称可能略有差异。
Claude Code
- 1在终端中运行下方命令以添加服务。
- 2在 Claude Code 中打开 /mcp,选择 nanobanana,并在浏览器中完成登录。
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1在终端中运行第一条命令以添加服务。
- 2运行第二条命令,浏览器窗口随即打开。
- 3登录账号并点击“允许”。
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor 与 JSON 客户端
- 1将以下内容添加到客户端的 MCP 配置文件中,例如 Cursor 的 mcp.json。
- 2如有需要,请重启客户端。首次使用时会打开浏览器窗口,请登录并点击“允许”。
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}自定义连接器
- 1打开客户端设置,找到自定义连接器或远程 MCP 服务的输入框。
- 2粘贴下方显示的服务地址并保存。
- 3选择“连接”,登录账号并点击“允许”。
https://preview.bananapro.site/api/mcpAPI 密钥
- 1仅在客户端无法打开浏览器时使用此方式。
- 2在 API 密钥页面创建密钥,并通过首个字段所示的请求头发送;使用 JSON 配置时,可按第二个字段所示写入 headers。
- 3请将密钥保存在客户端的凭据设置中,切勿向他人透露。
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}助手可以执行的操作
服务提供六个工具:四个仅读取信息,不消耗积分;两个用于发起生成,会消耗积分。
| 工具 | 作用 | 是否消耗积分 |
|---|---|---|
| list_models | 列出您的账号可用的图片与视频模型,以及各模型支持的请求类型。 | 否 |
| get_balance | 查询账号剩余积分。 | 否 |
| generate_image | 根据提示词和可选的参考图片,发起图片生成或图片编辑。 | 是 |
| generate_video | 根据提示词、图片或其他参考素材,发起视频生成。 | 是 |
| get_task | 查询生成任务的状态,任务完成后返回结果链接。 | 否 |
| list_tasks | 列出近期的生成任务,可用于找回遗失的任务编号。 | 否 |
命令行工具
nanobanana 命令可在终端、脚本以及能在您电脑上运行命令的 AI 应用中生成图片和视频。
需要 Node.js 22 或更高版本,支持 macOS 和 Linux。
安装 CLI
使用 npm 安装 @nanobanana-pro/cli 软件包。
npm install -g @nanobanana-pro/cli登录
运行该命令,然后在弹出的浏览器窗口中登录账号并点击“允许”。
nanobanana auth login查看账号与模型
此命令显示您的积分余额。命令 nanobanana models 会列出可用模型。
nanobanana account发起生成
将模型和提示词写入 request.json,然后运行该命令。选项 --wait 会让命令一直运行到任务完成。
nanobanana create --input request.json --wait下载结果
将 TASK_ID 替换为上一条命令返回的任务 ID。
nanobanana download TASK_ID --output result.png
运行示例
只需一句话描述图片。您的 AI 应用会编写请求、生成图片并保存文件。
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
可用模型
助手可以使用您的账号在网站和 API 中可用的图片与视频模型。
- 请助手调用 list_models,即可获得当前模型列表及各模型支持的请求类型。
- 各模型提供的选项与网站一致;模型不支持的设置会被拒绝并附带说明。
- 参考图片和视频须为公开的 https 链接,MCP 不支持上传文件。
积分与计费
- 登录以及免费工具(list_models、get_balance、get_task、list_tasks)不消耗积分。
- generate_image 与 generate_video 消耗的积分与网站和 API 相同,从您的账号余额中扣除。
- 失败的任务会自动退还积分。
- AI 助手本身的订阅费用与此无关,由该助手另行收取。
示例请求
接入完成后,可向助手发送以下请求。
- 我可以使用哪些图片和视频模型?请用简短列表列出。
- 生成一张 16:9 的商品图:木桌上的一只陶瓷马克杯。
- 把这张风景照片做成五秒钟的视频:https://example.com/photo.jpg
- 查看我最近一个任务的状态,并把结果链接发给我。
常见问题
需要 API 密钥吗?
能够打开浏览器的客户端不需要,登录并点击“允许”即可。仅无法打开浏览器的客户端才需要密钥,方法见“API 密钥”。
在哪里查看或移除连接?
打开 API 密钥页面。每个连接都会以客户端名称显示在该页面,移除后该客户端将无法继续访问。
一次生成需要多少积分?
与网站和 API 的积分消耗相同。失败的任务会自动退还积分。
可以使用自己的图片或视频作为参考吗?
可以,但须为公开的 https 链接。不支持上传文件,请将文件放在可访问的位置并提供其地址。
连接成功但看不到工具,怎么办?
请确认登录已完成,且客户端显示该服务已连接。然后新开一个对话,因为部分客户端仅在对话开始时加载工具。
在哪里查看生成结果?
助手会在对话中返回结果链接。之前的任务可通过 list_tasks 重新列出。
希望直接调用 API?
MCP 服务基于公开 API 构建。文档中列有全部接口、参数与模型。