返回博客
BananaBanana Teamapix402agents

基于 x402 的 AI 生成 API：按次付费，无需注册账号

通过 x402 协议生成图像、视频和语音：智能体在 Base 网络上使用 USDC 按次付费，无需注册或 API 密钥。单次生成 $0.03 起。

基于 x402 的 AI 生成 API：按次付费，无需注册账号

x402 是一项开放支付协议，它将闲置已久的 HTTP 402 状态码转化为实用的付费网关：服务器在响应中返回 402 Payment Required 以及机器可读的支付条件，客户端签署稳定币转账授权，重新发送请求后即可获取结果。无需注册账号，无需申请 API 密钥，更无月度订阅。Coinbase 于 2026 年 4 月将该协议移交给了 Linux Foundation，在 x402 Foundation 正式投入运营时，已有包括 AWS、Google、Stripe、Visa 和 Mastercard 在内的 40 家成员机构加入。这已不再是边缘的加密技术实验。

快速解答： BananaBanana 的 x402 接口地址为 https://bananabanana.pro/api/x402。发送包含 { "tool": "...", "arguments": {...} } 的 POST 请求，接收包含对应参数精确报价的 402 响应，在 Base 网络上使用 USDC 完成支付并重发请求。图像生成 $0.03 起，视频生成 $0.30 起，语音合成每 200 字符 $0.01。图像与语音仅在文件实际生成成功后才会扣费。

小型机器人将硬币投入自动售货机，机器吐出图像、胶卷和扬声器，社论插画风格

最后一句话正是许多介绍 x402 的文章所忽略的关键细节，也是我们重点阐述的内容。收费并不困难；而在生成失败时不扣除任何费用，才是软件架构设计的精髓所在。

支付的具体流程

只需四个步骤，其中三个由您的 HTTP 客户端自动完成：

  1. 智能体发送常规的 JSON POST 请求，不带任何支付请求头。
  2. 服务器返回包含 accepts 数组的 402 响应。支付要求中注明了以最小原子单位计量的金额、收款地址、USDC 合约、所在网络及有效时限。
  3. 客户端针对该金额签署一份 EIP-3009 转账授权，并将其 Base64 编码后填入 X-PAYMENT 请求头。
  4. 带着该请求头重新发送相同的请求。服务器将签名交由撮合方（facilitator）验证，执行生成任务，随后由撮合方完成链上结算。

签名并非直接发起的链上交易，而是一份链下授权，只有在被提交至网络时才会转化为实际转账。这种机制使得“先验证、后生成、最后结算”的两阶段设计成为可能。

开发细节：v2 规范将请求头重命名为 PAYMENT-SIGNATURE 和 PAYMENT-RESPONSE，但目前多数客户端仍发送 X-PAYMENT，我们对此完全兼容。如果您使用的是官方 TypeScript SDK，这一细节已完全封装。

展示智能体与付费 API 之间四步请求循环的图表式插画，社论风格

单次调用费用

价格按生成次数计算，并在签署任何授权前明确告知。具体费用取决于输入参数（4K 图像价格高于 1K 图像），因此 402 响应是对您的具体请求进行实时定价。

工具模型价格
generate_imageNano Banana 2 Lite$0.03（仅限 1K）
generate_imageNano Banana 2$0.03 – $0.13（512 至 4K）
generate_imageNano Banana Pro$0.11 – $0.20（1K 至 4K）
generate_videoGemini Omni Flash每秒 $0.10，3–10 秒，含音频
generate_videoVeo 3.1 系列每段 $0.10 – $4.40
generate_speechGemini Flash TTS每起始 200 字符 $0.01

在 Omni 上生成一段带声音的 3 秒视频仅需 $0.30，是列表中最经济的真实视频生成选项。Veo 能提供更高的画面细节，但若生成 8 秒 1080p 带音效的视频，作为初期初稿成本会相对较高。

您可以随时直接查询实时价格目录：GET https://bananabanana.pro/api/x402 免费返回全部模型列表，无需任何支付。

不同大小的硬币摆放在小画框和胶卷图案旁，社论插画风格

完整请求演示

以下是通过 curl 实现的完整调用流程（不包含由 x402 客户端库处理的签名步骤）：

# 1. 请求报价。不带支付头：获取费用明细。
curl -s -X POST https://bananabanana.pro/api/x402 \
  -H 'Content-Type: application/json' \
  -d '{"tool":"generate_image","arguments":{"prompt":"a paper boat on still water at dawn","model":"nano-banana-pro","resolution":"2048"}}'
{
  "x402Version": 1,
  "error": "Payment required: $0.11 for generate_image.",
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "110000",
    "resource": "https://bananabanana.pro/api/x402",
    "payTo": "0x7c0e9abd1c48380e27ab5bfced1be54f23ce773f",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "maxTimeoutSeconds": 300,
    "extra": { "name": "USD Coin", "version": "2" }
  }]
}

一条线上的两个信封：第一个带着挂锁返回，第二个带有火漆印并穿过打开的框架

对参数进行签名并携带请求头重新提交，第二次响应将直接返回生成的文件：

{
  "paid_usd": 0.11,
  "result": {
    "status": "completed",
    "images": [{ "url": "https://bananabanana.pro/api/files/..." }]
  }
}

对于构建 x402 服务端的技术要点：maxAmountRequired 使用最小原子单位。由于 USDC 具有 6 位小数，$0.11 对应的数值为 110000。此外，extra.name 必须与 USDC 合约的 name() 方法返回值严格一致（在 Base mainnet 上为 USD Coin，在 Base Sepolia 上为 USDC），该值参与计算 EIP-712 的 domain separator。若不匹配，签名验证将直接失败且通常缺乏明确错误提示。

视频生成的差异：预结算与失败退款凭证

图像与语音合成均可在单次 HTTP 请求的时限内完成（验证 → 生成 → 结算）。只有在文件成功产出时才会实际扣费。若遭遇内容安全策略拦截或超时，签名不会提交上链，用户无需承担任何费用。

视频生成则有所不同：Veo 或 Omni 的渲染通常需要 1 到 10 分钟，无法维持长时间挂起的 HTTP 连接，且 Google 端启动的生成任务无法取消（其 interactions.cancel 接口返回 501 UNIMPLEMENTED）。因此，视频任务会在启动前先行结算，返回一个 job_id，随后通过免费接口轮询结果。

如果已付费的视频任务被安全审核拦截，该如何处理？

系统会发放一个全额退款凭证（refund token，格式为 bb_rf_…），有效期 90 天，可在随后的任何请求中通过 refund_token 参数抵扣费用。如果此前支付 $1.30 的视频被拦截，下一次请求即可直接抵减 $1.30。若新任务费用低于凭证面额，余额会生成新的凭证返还。

这并非链上的 USDC 退款。我们的服务器不持有私钥，无法发起主动转账，仅能接受或拒绝收款。对于 x402 服务的安全性而言，服务器不存储私钥是一项坚实的防护措施。

上面这段视频正是通过该 x402 接口以 $0.30 生成的：采用 Gemini Omni Flash 模型，时长 3 秒，提示词为玻璃水箱中墨水在水中扩散的连续镜头、柔和侧光及低频环境音。音频直接由模型合成。

智能体如何自动发现接口

若智能体已知精确 URL，则无需额外的发现步骤。对于其他智能体，我们在 /.well-known/x402（及 /.well-known/x402.json）公开发布了服务清单。

清单将每个工具作为独立资源列出，附带支付要求、CAIP-2 标准网络标识、收款地址与撮合方。清单中的 accepts 区块标注的是工具的起步价格而非上限，以防止智能体在检索服务时意外多付。

智能体目录服务也会通过空的 POST 请求探测接口，我们的服务器会统一返回包含工具调用指引的 402 响应。

带有一个拉开抽屉的目录卡片柜，露出泛光的端点标签，社论插画风格

x402 与注册账户的对比

通往同一房间的两扇门：一扇由夹着硬币的机械爪打开，另一扇由拿着钥匙的手打开

两种方式调用的底层生成模型完全一致。您可以根据智能体的架构需求进行选择。

维度x402账户模式（MCP 或网页版）
配置门槛持有余额的加密钱包邮箱注册，随后获取 API 密钥或 OAuth
单次调用签名、即时结算从预充值余额中扣除
充值优惠无$50+ 赠 5%，$100+ 赠 10%，优惠码再加 10%
生成历史不保留完整历史记录，支持复用 job ID
视频编辑不支持支持 edit_video 连续对话式调整
适用场景单次调用、全自主智能体持续项目、成本精细管控、多轮迭代

充值赠金是一项显著优势：使用优惠码充值 $100 可得 $120 额度（相当于 17% 的实际折扣），而 x402 因无账户余额机制不享受该优惠。另一方面，拥有钱包的自主智能体无需邮箱，仅需一次请求往返即可开始生成。

如果您偏好账户模式，我们的 MCP 服务器支持 Claude Code、Cursor 和 VS Code，网页生成器也可以直接在浏览器中使用。

常见问题

支付需要 Coinbase 账户吗？

不需要。只要是在 Base 网络上持有 USDC 的任意 EVM 钱包均可完成支付。结算由撮合方处理，您无需在其平台注册。

如果生成任务被内容安全过滤拦截怎么办？

对于图像和语音，完全不会产生扣费，因为仅在生成文件成功后才执行结算。对于视频任务，您将获得等额的退款凭证用于后续抵扣。

支持哪些区块链网络与代币？

Base 主网（Base mainnet）上的 USDC，支付模式为 exact。/.well-known/x402 清单中包含具体的 CAIP-2 链 ID 与代币合约地址。

可以对通过 x402 生成的视频进行二次编辑吗？

x402 不支持二次编辑。编辑功能依赖于账户内的任务历史记录（MCP 中的 edit_video）。在 x402 上，您可以随时重新生成全新的视频。

报价的有效期有多长？

签名时间窗口默认设置为 300 秒（maxTimeoutSeconds 参数）。基础价格与网站公布的费率一致，在会话期间保持稳定。

欢迎在实际接口上体验一次 $0.03 的图像生成。只要您的客户端能够签署 EIP-3009 授权，只需四行代码即可获得生成的图像。

apix402agents