Machine Payments 允许客户端从稳定币钱包为选定的开放模型推理调用付费,而无需维持预付积分余额。要使用 Machine Payments,你必须位于美国,并且账户中已存档信用卡。
Payment-Method: x402 标头告知 Cloudflare 通过 x402 协议 ↗协商付款。该标头为 Cloudflare 专用。
- 确保你的 Cloudflare 账户已存档信用卡。
- 确保你已认证 AI Gateway。
z-ai/glm-4.7-flashgoogle/gemma-4-26b-a4b-itopenai/gpt-oss-20balibaba/qwen3.8-27b
Machine Payments 适用于 Cloudflare API,并需要 Cloudflare API 令牌。
兼容 x402 的客户端会自动处理质询和重试。
- 客户端发送带有 Cloudflare 专用
Payment-Method: x402标头的推理请求。这会请求使用 x402 付款,而不是使用账户已配置的计费方式。 - AI Gateway 验证请求并返回
402 Payment Required。标准的PAYMENT-REQUIRED响应标头包含接受的网络、资产、付款方案和最大授权金额。大多数 AI Gateway 模型使用upto付款方案,表示客户端最多可能被收取的金额。HTTP/1.1 402 Payment Required PAYMENT-REQUIRED: <base64-encoded payment requirements> - x402 客户端解码付款要求。钱包会签署最高达该最大金额的授权。
- 客户端使用标准
PAYMENT-SIGNATURE请求标头中的已签名授权,重试同一推理请求。 - Cloudflare 验证授权并运行推理请求。Cloudflare 会结算实际请求成本,该成本不能超过已授权的最大值。
- AI Gateway 返回推理响应。
目前,仅 /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 了解更多详情。