跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Machine Payments (x402)

最后更新 查看 MarkdownAgent 设置

Machine Payments 允许客户端从稳定币钱包为选定的开放模型推理调用付费,而无需维持预付积分余额。要使用 Machine Payments,你必须位于美国,并且账户中已存档信用卡。

Payment-Method: x402 标头告知 Cloudflare 通过 x402 协议 ↗协商付款。该标头为 Cloudflare 专用。

前提条件

  • 确保你的 Cloudflare 账户已存档信用卡。
  • 确保你已认证 AI Gateway。

符合条件的端点

符合条件的模型

  • z-ai/glm-4.7-flash
  • google/gemma-4-26b-a4b-it
  • openai/gpt-oss-20b
  • alibaba/qwen3.8-27b

使用 Machine Payments

Machine Payments 适用于 Cloudflare API,并需要 Cloudflare API 令牌。

交易流程

兼容 x402 的客户端会自动处理质询和重试。

  1. 客户端发送带有 Cloudflare 专用 Payment-Method: x402 标头的推理请求。这会请求使用 x402 付款,而不是使用账户已配置的计费方式。
  2. AI Gateway 验证请求并返回 402 Payment Required。标准的 PAYMENT-REQUIRED 响应标头包含接受的网络、资产、付款方案和最大授权金额。大多数 AI Gateway 模型使用 upto 付款方案,表示客户端最多可能被收取的金额。
    HTTP/1.1 402 Payment Required
    PAYMENT-REQUIRED: <base64-encoded payment requirements>
  3. x402 客户端解码付款要求。钱包会签署最高达该最大金额的授权。
  4. 客户端使用标准 PAYMENT-SIGNATURE 请求标头中的已签名授权,重试同一推理请求。
  5. Cloudflare 验证授权并运行推理请求。Cloudflare 会结算实际请求成本,该成本不能超过已授权的最大值。
  6. AI Gateway 返回推理响应。

REST API

目前,仅 /ai/run 端点可用于 Machine Payments。

使用 Cloudflare API 调用第三方模型。在 Authorization 标头中传递 Cloudflare API 令牌,并包含 Payment-Method: x402 标头。如果未传递该标头,AI Gateway 会遵循正常的凭据优先级,并可能从你的 Unified Billing 积分余额中扣除推理成本。

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -iX POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Payment-Method: x402" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "z-ai/glm-4.7-flash",
    "input": {
      "max_tokens": 9001,
      "messages": [
        {
          "role": "user",
          "content": "What is Cloudflare?"
        }
      ]
    }
  }'

请参阅 REST API 了解更多详情。

这篇文档对您有帮助吗?