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

统一计费

最后更新 查看 MarkdownAgent 设置

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 加载积分:

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

    前往 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 页面。

    前往 AI Gateway ↗
  2. 在 Credits Available(可用积分) 中,选择 Manage(管理)。

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

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

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

凭据优先级

当请求到达 AI Gateway 时,凭据按以下顺序解析:

  1. 请求中的提供程序密钥 — 如果请求携带 AI Gateway 可识别、适用于该提供程序和端点的凭据,AI Gateway 就会使用这些凭据。不会使用 BYOK 或统一计费。
  2. BYOK(已存储密钥) — 如果请求上没有提供商密钥,且 gateway 在 default 别名下为该提供商存储了密钥,则使用该密钥。
  3. 统一计费 — 如果以上方式均不适用,且允许使用统一计费回退,则会使用 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。

阻止 BYOK 第三方提供商回退到 Unified Billing

开启 Require provider credentials(要求提供商凭据),以阻止第三方提供商回退到 Unified Billing。第三方提供商请求必须使用随请求提供或存储在 gateway 上的凭据。没有适用凭据的请求会返回 HTTP 400 响应,而不是使用 Cloudflare 管理的凭据。

  1. 登录 Cloudflare 仪表板 ↗并前往 AI > AI Gateway。

    前往 AI Gateway ↗
  2. 选择你的 gateway。

  3. 前往 Settings(设置) 并开启 Require provider credentials(要求提供商凭据)。

  4. 确认更改。

发送 PUT 请求 更新 gateway。在请求正文中包含 byok_only: true。

若要为单个第三方提供商请求要求提供商凭据,将 cf-aig-no-wholesale 标头设为 true。该标头可以阻止回退到 Unified Billing,但不能放宽 gateway 设置。如果已开启 Require provider credentials(要求提供商凭据),将该标头设为 false 无效。

Workers AI 请求不使用提供商凭据。此设置不会阻止这些请求,也不会更改 gateway 已配置的 Workers AI 计费模式。

使用 Unified Billing

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 模型,并为前沿模型提供更高的速率限制。

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 接口。

HTTP API

通过 AI Gateway REST API 调用支持的提供商,无需传递提供商 API 密钥。

REST 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。

AI Gateway 提供商原生端点

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

HTTP API 支持以下提供商:

支出限制

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

Zero Data Retention (ZDR)(零数据保留)

Zero Data Retention (ZDR) 通过不保留提示和响应的提供商端点路由 Unified Billing 流量。ZDR 仅适用于使用 Cloudflare 管理凭据的 Unified Billing 请求。不适用于 BYOK 或其他 AI Gateway 请求。

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

请参阅模型目录,确认模型是否支持 Zero Data Retention (ZDR)。

这篇文档对您有帮助吗?