Unified Billing 允许用户调用 Workers AI,并连接到各种 AI 提供商(如 OpenAI、Anthropic 和 Google AI Studio),然后收到单一 Cloudflare 账单。要使用 Unified Billing,你必须在 Cloudflare 仪表板中购买并将积分加载到 Cloudflare 账户,然后可以通过 AI Gateway 消费。
通过 Unified Billing 购买的所有积分收取 5% 费用。例如,购买 $100 积分将产生 $105 费用。提供商推理定价无加价传递 — 你支付与直接向提供商支付相同的每 token 费率。
- 确保你的 Cloudflare 账户已加载足够的积分。
- 确保你已认证 AI Gateway。
- 要将积分用于 Workers AI,请将 gateway 的 Workers AI Billing 设置设为 Unified billing。
要为 AI Gateway 加载积分:
-
在 Cloudflare 仪表板中,前往 AI Gateway 页面。
前往 AI Gateway ↗右上角的 Credits Available(可用积分) 卡片显示你账户当前拥有的 AI Gateway 积分数量。
-
在 Credits Available(可用积分) 中,选择 Manage(管理)。
-
如果你的账户没有可用的付款方式,AI Gateway 将提示你添加付款方式以购买积分。添加付款方式。
-
选择 Top-up credits(充值积分)。
-
添加要购买的积分数量,然后选择 Confirm and pay(确认并支付)。
你可以配置 AI Gateway 在积分低于特定阈值时自动补充。要配置自动充值:
-
在 Cloudflare 仪表板中,前往 AI Gateway 页面。
前往 AI Gateway ↗ -
在 Credits Available(可用积分) 中,选择 Manage(管理)。
-
选择 Setup auto top-up credits(设置自动充值积分)。
-
为自动充值选择阈值和充值金额。
当余额低于设定阈值时,AI Gateway 将自动将自动充值金额应用到你的账户。
当请求到达 AI Gateway 时,凭据按以下顺序解析:
- 请求中的提供程序密钥 — 如果请求携带 AI Gateway 可识别、适用于该提供程序和端点的凭据,AI Gateway 就会使用这些凭据。不会使用 BYOK 或统一计费。
- BYOK(已存储密钥) — 如果请求上没有提供商密钥,且 gateway 在
default别名下为该提供商存储了密钥,则使用该密钥。 - 统一计费 — 如果以上方式均不适用,且允许使用统一计费回退,则会使用 Cloudflare 管理的凭据处理请求,并从你的 Cloudflare 信用余额中扣费。
对于统一计费支持的第三方提供程序,AI Gateway 会在提供程序原生端点上识别以下请求凭据:
| 提供商 | 端点 | 请求凭据 |
|---|---|---|
| Anthropic | 消息 (/anthropic/v1/messages) |
x-api-key: <PROVIDER_API_KEY> |
| Anthropic | 聊天补全 (/anthropic/v1/chat/completions) |
Authorization: Bearer <PROVIDER_API_KEY> |
| Google AI Studio | 原生 :generateContent、:streamGenerateContent 和 :embedContent |
URL 查询参数 key |
| Google AI Studio | 聊天补全 | Authorization: Bearer <PROVIDER_API_KEY> |
| Google AI Studio | 其他端点 | x-goog-api-key: <PROVIDER_API_KEY> |
| Google Vertex AI | 提供程序原生端点 | Authorization: Bearer <ACCESS_TOKEN>,或 Authorization 中的服务账号凭据。 |
| OpenAI、Groq 和 xAI | 提供程序原生端点 | Authorization: Bearer <PROVIDER_API_KEY> |
对于 Anthropic Messages,请在 x-api-key 中发送提供程序密钥。AI Gateway 不会将此端点上的 Authorization: Bearer 识别为提供程序凭据。仅提供 Bearer 标头并不能阻止系统查找已存储的密钥或回退到统一计费。
如需阻止回退到统一计费,请要求提供提供程序凭据。如果 AI Gateway 找不到适用的请求凭据或已存储凭据,则会返回错误 2044。
开启 Require provider credentials(要求提供商凭据),以阻止第三方提供商回退到 Unified Billing。第三方提供商请求必须使用随请求提供或存储在 gateway 上的凭据。没有适用凭据的请求会返回 HTTP 400 响应,而不是使用 Cloudflare 管理的凭据。
-
登录 Cloudflare 仪表板 ↗并前往 AI > AI Gateway。
前往 AI Gateway ↗ -
选择你的 gateway。
-
前往 Settings(设置) 并开启 Require provider credentials(要求提供商凭据)。
-
确认更改。
发送 PUT 请求 更新 gateway。在请求正文中包含 byok_only: true。
若要为单个第三方提供商请求要求提供商凭据,将 cf-aig-no-wholesale 标头设为 true。该标头可以阻止回退到 Unified Billing,但不能放宽 gateway 设置。如果已开启 Require provider credentials(要求提供商凭据),将该标头设为 false 无效。
Workers AI 请求不使用提供商凭据。此设置不会阻止这些请求,也不会更改 gateway 已配置的 Workers AI 计费模式。
Unified Billing 有两种工作方式:通过 AI 绑定或通过 HTTP API。两者都自动从你的账户扣除积分,无需提供商 API 密钥。
要将积分用于 Workers AI,请将 gateway 的 Workers AI 计费设置 配置为 Unified billing。通过该 gateway 路由的 Workers AI 请求会实时从预付积分余额中扣除。在 AI 绑定中,于 env.AI.run() 的第三个参数中包含 gateway ID。对于 REST API 请求,包含 cf-aig-gateway-id 标头。预付积分可访问原本需要 Workers Paid 计划的 Workers AI 模型,并为前沿模型提供更高的速率限制。
使用 env.AI.run() 调用模型目录中列出的任何模型。这包括 Workers AI 模型以及来自 OpenAI、Anthropic 和 Google 等提供商的第三方模型。
const resp = await env.AI.run(
"openai/gpt-4.1-mini",
{
messages: [{ role: "user", content: "What is Cloudflare?" }],
},
{
gateway: { id: "my-gateway" },
},
);请参阅绑定参考了解完整 API 接口。
通过 AI Gateway REST API 调用支持的提供商,无需传递提供商 API 密钥。
使用 Cloudflare API 调用第三方模型。在 Authorization 标头中传递 Cloudflare API 令牌:
# 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 -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-4.1-mini",
"messages": [{"role": "user", "content": "What is Cloudflare?"}]
}'请参阅 REST API 了解所有可用端点的更多详情。
Machine Payments 提供预付 Unified Billing 积分之外的另一种方式:客户端通过包含 Cloudflare 专用的 Payment-Method: x402 标头,从稳定币钱包为推理付费。
AI Gateway 返回带有付款要求的 402 Payment Required 响应。兼容 x402 的客户端授权付款,并使用 PAYMENT-SIGNATURE 标头重试请求。如果请求不包含 Payment-Method: x402,AI Gateway 会遵循正常的凭据优先级,并可能从你的 Unified Billing 积分余额中扣除推理成本。
有关资格要求、支持的模型、交易流程和 REST API 示例,请参阅 Machine Payments。
你也可以使用 cf-aig-authorization 标头进行身份验证,通过提供商原生端点直接调用提供商:
HTTP API 支持以下提供商:
在单个 gateway 上设置支出限制规则以限制支出,按模型、提供商或用户或团队等自定义元数据维度限定范围。
Zero Data Retention (ZDR) 通过不保留提示和响应的提供商端点路由 Unified Billing 流量。ZDR 仅适用于使用 Cloudflare 管理凭据的 Unified Billing 请求。不适用于 BYOK 或其他 AI Gateway 请求。
ZDR 不控制 AI Gateway 日志记录。要在 AI Gateway 中禁用请求/响应日志记录,请在日志记录中单独更新日志设置。
请参阅模型目录,确认模型是否支持 Zero Data Retention (ZDR)。