BananaBanana

BananaBanana MCP 服务

用于图像、视频和语音生成的 MCP 服务，支持 Google Nano Banana、Veo 3.1 和 Gemini Omni、OpenAI GPT Image 2.5、Alibaba Qwen Image 和 Wan 3.0、xAI Grok Imagine Video 以及 Gemini TTS，让任何 MCP 客户端（Claude Code、Claude Desktop、Cursor 等）都能按量付费创作媒体，支持加密货币或银行卡付款，且无需订阅。

• 端点： https://bananabanana.pro/api/mcp（可流式传输的 HTTP）
• 身份验证： OAuth 2.1（登录即可，无需复制任何内容）或 Authorization: Bearer bb_live_… — 创建密钥
• 网站： https://bananabanana.pro/?utm_source=mcp_readme&utm_medium=mcp_catalog · 文档和在线示例： https://bananabanana.pro/mcp?utm_source=mcp_readme&utm_medium=mcp_catalog

图像生成价格低至 $0.03，视频生成低至 $0.09；语音生成每开始处理 200 个转录字符收费 $0.01。费用从账户余额中扣除，你可以使用加密货币（最低 $1）或银行卡、PayPal 或 SEPA（最低 $20）充值。每次高额调用前都会提供费用估算，失败时自动退款，图像和视频历史记录可与网站共享。

当前文档版本：v1.0.12 — 已于 2026-09-30 根据已部署的工具架构和模型目录完成审核。请参阅更新日志。

快速开始

OAuth 是首选连接方式。不支持 OAuth 的客户端以及脚本或 CI 仍可使用 API 密钥：

• OAuth 2.1（claude.ai、Claude Desktop、Claude 移动版、Claude Code、MCP Inspector）：添加自定义连接器，填入上述 URL，点击 Connect 并批准访问。无需复制密钥。请参阅 docs/authentication.md。
• API 密钥（Cursor、VS Code、Windsurf、Codex、脚本、CI）：在个人资料中创建密钥 — https://bananabanana.pro/profile?utm_source=mcp_readme&utm_medium=mcp_catalog，位于 API Keys 部分 — 并按下方所示将其填入客户端配置。

claude.ai / Claude Desktop / 移动版（OAuth）

Settings → Connectors → Add custom connector
URL: https://bananabanana.pro/api/mcp
→ Add → Connect → approve access on bananabanana.pro

Claude Code

# OAuth — no key; run /mcp inside Claude Code and choose "Authenticate"
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp

# API-key fallback for non-interactive use
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
  --header "Authorization: Bearer bb_live_YOUR_KEY"

Claude Desktop

使用 Settings → Connectors → Add custom connector，输入 https://bananabanana.pro/api/mcp，然后点击 Connect 并批准访问。如果你的 Desktop 版本使用 claude_desktop_config.json，支持 OAuth 的 mcp-remote 桥接程序 需要 Node.js：

{
  "mcpServers": {
    "bananabanana": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://bananabanana.pro/api/mcp"
      ]
    }
  }
}

桥接程序会在首次使用时打开 OAuth 登录流程。API 密钥备用方案请参阅 docs/authentication.md。

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "headers": { "Authorization": "Bearer bb_live_YOUR_KEY" }
    }
  }
}

{
  "servers": {
    "bananabanana": {
      "type": "http",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": { "Authorization": "Bearer ${input:bb-api-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "bb-api-key", "description": "BananaBanana API key (bb_live_…)", "password": true }
  ]
}

{
  "mcpServers": {
    "bananabanana": {
      "serverUrl": "https://bananabanana.pro/api/mcp",
      "headers": { "Authorization": "Bearer bb_live_YOUR_KEY" }
    }
  }
}

可直接复制的配置位于 examples/。连接后，让你的 Agent 运行 list_models（免费）即可获取实时模型列表和价格。OAuth 用户还可以让 Agent 调用 top_up；返回的浏览器链接仅授予充值权限，不会暴露完整个人资料。

**没有 MCP 客户端？**该服务通过 HTTPS 使用纯 JSON-RPC，可通过 curl、Python 或 TypeScript 调用，无需 SDK：examples/no-sdk.md（可运行脚本：generate.py、generate.mjs）。

工具

共有 10 个工具；只读工具和账户访问工具免费。完整参考请见 docs/tools.md。

图像和视频生成是异步的：生成 / 编辑调用会返回 job_id；通过 get_result 轮询获取媒体。generate_speech 是同步的，会直接返回其 WAV URL。generate_video、edit_video 和多图 generate_image 会先报价，只有在重复调用并传入 confirm_cost 后才会扣费。

生成的文件会从创建之日起保留 30 天；签名下载链接的有效期为 24 小时。在保留期限内，get_result 可以生成新的图像 / 视频链接。请从同步响应中下载语音；语音不会出现在 list_generations 中。

定价

按量付费，使用美元计价：按张图片、每段 Veo 视频、Omni Flash、Wan 3.0 和 Grok Imagine Video 的每秒输出，以及每满 200 个转录字符的语音生成费用计费。 实时价格来自 list_models，完整价格表见 docs/pricing.md。

图片费用为每张 $0.03–$0.20；视频费用为每段 $0.09–$6.00。Veo 按每段视频计价，而 Omni Flash、Wan 3.0 和 Grok Imagine Video 则按输出秒数计费，价格遵循供应商的官方报价。Veo 生成时长可选 4、6 或 8 秒；list_models 返回的 7 秒价格适用于延长任务，并非 generate_video 可选的时长。Wan 3.0 支持首帧和尾帧、参考图片、参考视频及种子，并且可以免费关闭音轨。免费工具：list_models、get_account、top_up、get_result、list_generations。失败和被内容过滤器拦截的生成任务会自动退款。

充值奖励可降低实际成本：充值 $50 及以上可获 5% 额外余额，充值 $100 及以上可获 10% 额外余额；使用有效的合作伙伴促销码还可额外获赠 10%。奖励可叠加，适用于加密货币和银行卡充值。表格显示的是名义生成费用；实际自付金额取决于充值奖励。促销码需要正常登录的个人资料，在仅用于充值的 OAuth 会话中无法使用，这是有意为之。

为什么选择它，而不是订阅服务

• 按生成量付费，不收取其他费用。 没有月费、席位费，也没有会过期的额度。清闲的月份费用为 $0；你充值的余额就是唯一支出。
• Agent 在消费前就能看到价格。 list_models 会返回实时价格，视频 / 批处理调用会先返回报价，只有确认后才收费，因此 Agent 不会产生意外账单。
• 失败不会让你付费。 上游错误和内容过滤拒绝会自动退款；还可通过可选的每个密钥每日限额和 idempotency_key 进一步限制损失。
• 支持加密货币或银行卡，无需订阅。 加密货币充值最低 $1（大多数网络支持 USDT、USDC、DAI 和其他币种）；银行卡、PayPal 和 SEPA（欧盟）充值最低 $20，并通过 PayPal 的结账流程完成，因此银行卡信息不会传给该服务。充值 $50 及以上 / $100 及以上可获赠 5% / 10% 额外余额；使用有效的合作伙伴促销码还可额外获赠 10%。MCP 和网站共用同一笔余额，以及同一份图片 / 视频历史记录。

无需账户即可按次付费（x402）

独立的 HTTP 端点 https://bananabanana.pro/api/x402 支持使用 Base 上的 USDC 付款，无需账户、OAuth 或 API 密钥。该端点支持图像、视频和语音生成。图像和语音付款在成功后结算；视频需预付，若失败则会返还一个一次性退款额度令牌。请求格式、精确价格质询、轮询和输入限制详见 docs/x402.md。

注册表

已发布到官方 MCP 注册表，名称为 pro.bananabanana/image-video。规范描述文件为 server.json。查询方式：

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=pro.bananabanana/image-video"

链接

• 网站： https://bananabanana.pro/?utm_source=mcp_readme&utm_medium=mcp_catalog
• MCP 文档和在线示例： https://bananabanana.pro/mcp?utm_source=mcp_readme&utm_medium=mcp_catalog
• 创建 API 密钥： https://bananabanana.pro/profile?utm_source=mcp_readme&utm_medium=mcp_catalog
• x402 按次付费 · docs/x402.md
• 身份验证 · docs/authentication.md
• 工具参考 · docs/tools.md
• 定价和限制 · docs/pricing.md
• 故障排除 · docs/troubleshooting.md
• 支持： [email protected]

许可证

Apache-2.0 © BananaBanana。本仓库仅包含公开文档——不含服务端源代码、密钥或机密。