nanobanana
香蕉 Nano Banana × 你的 AI 助手

Nano Banana MCP：在 AI 助手里直接生成图片

MCP 是 AI 助手连接外部工具的通用协议。把 Nano Banana MCP 连接到支持 MCP 的 AI 助手后，用一句话描述需求，助手就能查询模型、提交生图、跟踪任务并取回图片，不用在网站和对话之间来回切换。

开始连接创建 API Key

用 Nano Banana MCP，从一句需求到可用的图片

边讨论，边出图

在写文章、做方案或开发网页的同一段对话里，直接请求封面图、产品图和配图。

由助手衔接操作

助手会查询当前可用的图像模型和参数、提交任务、轮询进度；你只需要关注内容和效果。

沿用香蕉账户

使用账户现有积分，和网页、OpenAPI 同一套按张计费，生成失败自动返还。连接 Nano Banana MCP 本身不会自动开始生成。

正在和 Higgsfield 对比？看 Higgsfield 替代方案对比，价格、模型和 MCP 登录方式并排列出。

一键接入：复制提示词，发给 AI 助手

选好你用的客户端，点下面的按钮：系统会新建一把专用钥匙并填进提示词，复制后直接发给它，它会帮你把 Nano Banana MCP 配好。

选择客户端
管理钥匙

每点一次都会新建一把专用钥匙。超过 10 把时会自动作废最早的一键接入钥匙（不动你手动建的），可在 API 页管理。提示词里含钥匙，请只发给你自己的 AI 工具。

三步接入 Nano Banana MCP

需要已充值的香蕉账户、有效 API Key，以及支持远程 Streamable HTTP 和自定义请求头的 MCP 客户端。

  1. 1.

    准备账户和密钥

    API 与 MCP 只对付费账户开放，仅有赠送积分不能调用。在 OpenAPI 页面创建一个专用 API Key；密钥只填进可信客户端的连接配置，不要发到聊天里。

  2. 2.

    添加 Nano Banana MCP 服务

    在 AI 工具的 MCP 设置里添加远程 HTTP 服务，填入下方地址和 Authorization 请求头。不要选择只支持本地命令的 stdio 模式。

  3. 3.

    确认工具，再提出需求

    连接后先让助手查询可用模型。能看到下方三个工具后，再描述图片需求，并明确允许使用积分。

服务地址
https://www.nano-banana.cn/api/mcp/
请求头
Authorization: Bearer YOUR_NANO_BANANA_API_KEY

把 YOUR_NANO_BANANA_API_KEY 换成你的密钥。本页不收集也不保存密钥。

连接配置参考

{
  "mcpServers": {
    "nano-banana": {
      "url": "https://www.nano-banana.cn/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_NANO_BANANA_API_KEY"
      }
    }
  }
}

JSON 示例适用于接受 url / headers 的客户端；Claude Code 用一条命令添加；Codex 示例从环境变量读取密钥。具体字段和配置文件位置以各客户端文档为准。

在常见 AI 工具中连接 Nano Banana MCP

支持 MCP 不等于支持本服务的鉴权方式。请同时确认客户端支持远程 HTTP 和自定义 Authorization 请求头。

Cursor

远程 HTTP + headers
  1. 在 MCP 设置中添加自定义服务，或编辑你使用的 MCP JSON 配置。
  2. 参考上方 JSON 添加 nano-banana 的 url 和 headers，在本地替换密钥占位符后保存。
  3. 启用香蕉工具，先查询模型；生成时按客户端提示确认工具调用。

不要把包含真实密钥的配置文件提交到代码仓库。

查看官方接入说明

Claude Code

一条命令添加
  1. 在终端运行上方「Claude Code」页签里的命令，把密钥占位符换成你的密钥。
  2. 在 Claude Code 里输入 /mcp，确认 nano-banana 已连接、能看到三个工具。
  3. 先让它查询可用模型，再描述图片需求。

命令会把密钥写入本机 Claude Code 配置，请只在自己的电脑上执行。

查看官方接入说明

Codex

远程 HTTP + 环境变量
  1. 在可信执行环境设置 NANO_BANANA_API_KEY，不要在聊天或提交的文件里写入密钥。
  2. 把上方 Codex TOML 配置加入当前使用的 Codex 配置文件。
  3. 重新加载 MCP 连接，确认香蕉工具可用后再请求出图。

远程或云端会话需要在实际执行环境里配置这个变量。

查看官方接入说明

WorkBuddy

先确认版本能力
  1. 打开 WorkBuddy 的 MCP / 工具管理入口，查找添加自定义远程服务的选项；具体菜单名称随版本变化。
  2. 如果支持 HTTP / Streamable HTTP 和自定义 headers，填入上方服务地址与 Bearer 请求头，保存并启用。
  3. 先发送「请查询香蕉可用的图片模型」验证连接。如果只有 stdio、旧 SSE 或 OAuth 入口，当前配置无法直接使用。

上方 JSON 是连接字段参考，不是经所有 WorkBuddy 版本验证的一键导入配置。

ChatGPT

当前鉴权存在兼容限制
  1. ChatGPT 的自定义 MCP 应用有自己的账户、工作区与鉴权要求，不等同于可以配置任意 headers 的 MCP 客户端。
  2. 香蕉目前只支持 API Key Bearer 请求头，没有提供 ChatGPT 常规连接流程需要的 OAuth 授权，因此不能只粘贴网址就使用。
  3. 如果你用的 ChatGPT 客户端明确支持自定义 Authorization 请求头，可以按上方参数尝试；否则请改用 Cursor、Claude Code 或 Codex。

ChatGPT 订阅不包含香蕉的生图积分。

查看官方接入说明

连接后，可以这样说

先说明用途、尺寸和参考图，再确认模型与费用。下面的示例只是提示词，复制后不会自动生成。

文章封面

先查询香蕉可用的图片模型，帮我挑一个适合文章封面的模型并说明每张多少积分。主题是「城市里的慢生活」，横版 16:9、自然光、不要文字。等我确认后只生成 1 张，返回任务 ID 和图片地址。

参考图改图

这是我的产品图公开链接：https://example.com/product.png 。先查询香蕉支持图生图的模型和价格，等我确认后用它生成 1 张简洁的电商白底场景图，保留产品外观。

批量配图

我要给一篇 5 段的教程配图。先列出每段的画面描述和推荐模型、总积分，等我确认后逐张提交，每张只提交一次，用同一个任务 ID 查询直到出图。

Nano Banana MCP 提供哪些工具

Nano Banana MCP 目前只提供图片生成。参考图需要是公开可访问的图片链接；能否读取本地文件、保存结果，取决于 AI 客户端自己的文件和网络权限。

list_models
查询可用的图像模型、参数限制和每张积分。
generate_media
提交一次图片生成（文生图或图生图），消耗账户积分。
query_task
查询已有任务的进度和图片地址，不会重新生成。

费用、连接与任务恢复

01

连接 Nano Banana MCP 会收费吗？

连接和查询模型不会提交生成。调用 generate_media 才会按所选模型与参数扣积分，和网页、OpenAPI 同价，失败、超时、审核拒绝都会返还。AI 工具自身的订阅费另算。

02

哪些账户可以使用？

和 OpenAPI 一样，只对付费账户开放：充值、订阅、续费过都算；只有赠送积分的账户会收到 403 提示。通过 API Key 调用时不需要验证码。

03

连接失败或出现 401 怎么办？

确认使用 https://www.nano-banana.cn/api/mcp/ 这个地址、远程 HTTP 模式和有效 API Key；请求头写成 Authorization: Bearer 加空格再加密钥，不要把密钥放进网址。客户端如果不支持自定义请求头或只支持 OAuth，就不能按本配置连接。

04

生成超时或断开怎么办？

网络超时不代表生成失败。让助手保存 generate_media 返回的 data.id，每隔至少 10 秒查询同一个任务，不要重新提交。无法确定是否提交成功时，到网站的任务记录里查看。

05

支持视频或上传本地文件吗？

目前不支持。香蕉 MCP 和 OpenAPI 一样只开放图像模型；参考图请提供公开的 http(s) 图片链接，服务端会先转存再生成。

06

如何保护 API Key？

给每个工具用单独的密钥，只写进它的安全配置。不要贴到聊天、公开仓库、截图或日志里。密钥只发送给 nano-banana.cn，下载图片时不要带上。泄露后立刻在控制台停用并重新创建。

准备好让 AI 助手帮你出图了吗？

创建专用 API Key，连接支持的客户端，从查询模型开始。

创建 API Key查看 API 文档查看任务记录