Unified Billing

Unified Billing 允许用户连接到各种 AI 提供商（如 OpenAI、Anthropic 和 Google AI Studio）并收到单一 Cloudflare 账单。要使用 Unified Billing，你必须在 Cloudflare 仪表板中购买并将积分加载到 Cloudflare 账户，然后可以通过 AI Gateway 消费。

通过 Unified Billing 购买的所有积分收取 5% 费用。例如，购买 $100 积分将产生 $105 费用。提供商推理定价无加价传递 — 你支付与直接向提供商支付相同的每 token 费率。

• 确保你的 Cloudflare 账户已加载足够的积分。
• 确保你已认证 AI Gateway。

要为 AI Gateway 加载积分：

1. 在 Cloudflare 仪表板中，前往 AI Gateway 页面。

   Go to AI Gateway ↗

   右上角的 Credits Available（可用积分） 卡片显示你账户当前拥有的 AI Gateway 积分数量。

2. 在 Credits Available（可用积分） 中，选择 Manage（管理）。

3. 如果你的账户没有可用的付款方式，AI Gateway 将提示你添加付款方式以购买积分。添加付款方式。

4. 选择 Top-up credits（充值积分）。

5. 添加要购买的积分数量，然后选择 Confirm and pay（确认并支付）。

你可以配置 AI Gateway 在积分低于特定阈值时自动补充。要配置自动充值：

1. 在 Cloudflare 仪表板中，前往 AI Gateway 页面。

   Go to AI Gateway ↗

2. 在 Credits Available（可用积分） 中，选择 Manage（管理）。

3. 选择 Setup auto top-up credits（设置自动充值积分）。

4. 为自动充值选择阈值和充值金额。

当余额低于设定阈值时，AI Gateway 将自动将自动充值金额应用到你的账户。

Unified Billing 有两种工作方式：通过 AI 绑定或通过 HTTP API。两者都自动从你的账户扣除积分，无需提供商 API 密钥。

使用 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 了解所有可用端点的更多详情。

你也可以使用 cf-aig-authorization 标头进行身份验证，通过提供商原生端点直接调用提供商：

HTTP API 支持以下提供商：

• OpenAI
• Anthropic
• Google AI Studio
• Google Vertex AI
• xAI
• Groq

在单个 gateway 上设置支出限制规则以限制支出，按模型、提供商或用户或团队等自定义元数据维度限定范围。

Zero Data Retention (ZDR) 通过不保留提示和响应的提供商端点路由 Unified Billing 流量。使用 gateway 级 zdr 设置启用它，该设置映射到支持 ZDR 的上游提供商配置。此设置仅适用于使用 Cloudflare 管理凭据的 Unified Billing 请求。不适用于 BYOK 或其他 AI Gateway 请求。

ZDR 不控制 AI Gateway 日志记录。要在 AI Gateway 中禁用请求/响应日志记录，请在日志记录中单独更新日志设置。

ZDR 目前支持：

• OpenAI
• Anthropic

如果为不支持 ZDR 的提供商启用 ZDR，AI Gateway 将回退到标准（非 ZDR）Unified Billing 配置。

使用 cf-aig-zdr 标头为单个 Unified Billing 请求覆盖 gateway 默认值。设置为 true 强制 ZDR，或 false 为该请求禁用 ZDR。

# 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" \
  --header "cf-aig-zdr: true" \
  --data '{
    "model": "openai/gpt-4.1-mini",
    "messages": [
      {
        "role": "user",
        "content": "Explain Zero Data Retention."
      }
    ]
  }'