401、403 或同步被拒绝？

检查完整 Token 是否有效、过期或撤销，Account ID 是否匹配，权限是否为目标账户的 AI Gateway Read，以及服务端 IP 是否符合 Token 策略。模型调用成功不证明余额权限有效；不要通过改用 Global API Key、Cookie 或全账户权限排错。

为什么是零、负数，或与其他 Cloudflare 费用不同？

这里只查询 Unified Billing 的 Credits。BYOK 和独立 Workers AI 账单不包含在内；Cloudflare 允许出现待结算的负 Credits，因此保留负值。请在相同账户的 Credits Available 对账，不将充值实付金额当余额。

金额看起来相差 100 倍？

公开新接口未注明金额单位，目前参考官方旧路径示例按美分除以 100 展示美元，尚待真实账户核验。请暂停以此金额设置资金决策，反馈查询时间与脱敏控制台金额；本站不会按数值大小自动猜单位或改用估算余额。

为什么多个项目显示相同余额？

同一 Account ID 的 AI Gateway 共用账户级 Credits。本站项目只是业务分组，不会在 Cloudflare 创建独立钱包；不要重复汇总同一账户资金。

充值后同步失败或金额暂未变化？

先确认付款已入账、账户一致，并查看最近一次成功同步时间。429 表示需稍后重试，接口不可用或格式变化会明确失败而非显示零；刷新不能加速 Cloudflare 的结算。无需为排查公开 Token。

Cloudflare AI Gateway 余额查询与只读 Token 接入

待真实账号验证

教程更新2026-10-11

适配已实现，待真实账号验证。公开余额接口未注明金额单位；当前依据 Cloudflare 官方示例按美分换算美元，首次请特别核对控制台金额与单位，不能把此状态理解为实测通过。

所需凭据: Cloudflare API Token
监控币种: USD · 美元
可以看到什么: 账户 AI Gateway Credits; 读取所选 Cloudflare 账户的 AI Gateway Unified Billing 共享 Credits。它不是某个 Gateway、API Key 或本站项目的独立钱包，也不是 Cloudflare 所有产品的总账户余额。

不接入 Quota Monitor，如何手动查看 Cloudflare AI Gateway 余额？

登录 Cloudflare Dashboard，选择实际使用的账户。
进入 AI → AI Gateway，在右上角查看 Credits Available（USD）。
点击 Manage 查看充值设置或充值；不要与 BYOK 供应商钱包或 Cloudflare 其他产品账单混用。

打开 Cloudflare Dashboard

在 Quota Monitor 中接入 Cloudflare AI Gateway

1. 确认账户和 Unified Billing 钱包
登录 Cloudflare Dashboard，选择实际运行 AI Gateway 的账户，进入 AI → AI Gateway。查看右上角 Credits Available；如有多个账户，先确认账户名称。仅使用 BYOK 或单独结算的 Workers AI，不代表这里会有资金。
完成后检查：你要监控的确实是这个账户的 AI Gateway Credits。接入监控不需要先充值，也不需要为了测试修改正在运行的 Gateway 的计费方式。
打开 Cloudflare Dashboard（在新标签页打开）
2. 复制 Account ID
保持正确账户被选中，按 Ctrl+K / Cmd+K 打开 Dashboard 搜索，输入 Copy account ID 并复制账户 ID；也可在 Workers & Pages 的 Account details 查看 Account ID。
完成后检查：复制的是 32 位十六进制 Account ID，不是 Zone ID、Gateway ID、账户名称或完整网址。不要将它填到本站的供应商项目 ID。
官方 Account ID 查找说明（在新标签页打开）
3. 新建专用自定义 Token
点击右上角头像 → My Profile → API Tokens → Create Token，在 Custom token 处点击 Get started，名称填写 Quota Monitor AI Gateway。使用新建的专用 Token，不修改已有生产 Token。
完成后检查：正在创建 API Token，不是查看 Global API Key 或生成可调用模型的 AI Gateway Run Token。
官方自定义 Token 创建步骤（在新标签页打开）
4. 只授权指定账户的读取权限
在 Permissions 中依次选择 Account → AI Gateway → Read。在 Account Resources 中选择 Include → Specific account，再选择步骤一的账户。删除与本用途无关的权限行，不选 All accounts、Write/Edit 或 Run。
完成后检查：只有目标账户的 AI Gateway Read。此权限并非只读余额，还允许其他 AI Gateway 读取操作；本站仅调用余额接口。找不到账户或权限时请账户管理员协助，不用更高权限替代。
5. 检查限制并保存完整 Token
按团队策略配置有效期。若使用 Client IP Address Filtering，允许的应是 Quota Monitor 服务端实际出口 IP，而非浏览器所在电脑的 IP；无法确认时先联系管理员，不绕过现有 IP 策略。点击 Continue to summary，复核权限和账户，再点 Create Token。
完整 Token 通常只显示一次，请保存到安全位置。完成后检查：复制的是 Token 秘密值，不是 Token ID；不要附加 Bearer 前缀，不发到聊天、截图或 MCP 参数。
6. 在项目内保存连接
回到 Quota Monitor，打开目标项目 → 添加供应商连接 → 添加新连接，选择 Cloudflare AI Gateway（美元 Credits）。填写便于识别的连接名称、步骤二的 Account ID 和步骤五的 API Token，然后保存并接入项目。
两项敏感字段均遮蔽并一起加密保存，列表仅显示 Token 末四位。无需填写 API 地址、Gateway ID 或供应商项目 ID。通过 MCP 接入时，使用安全录入链接填写同样字段，不把 Token 发给 Agent。
7. 同步并逐项核对金额
等待首次同步或点击查询最新余额，确认新的成功查询时间。打开同一 Cloudflare 账户的 AI Gateway，将美元金额与 Credits Available 对比，而非 Cloudflare 账单总额、Workers AI 用量或 BYOK 平台钱包。
完成后检查：账户、币种、金额单位和时间均正确。当前仍待真实账户验收，尤其检查是否存在 100 倍单位差异；若不符，只反馈错误码、时间和脱敏金额，不提供 Token。失败时旧快照不是新余额。
8. 需要充值时前往官方控制台
在卡片点击前往平台，选择同一账户 → AI Gateway → Credits Available → Manage → Top-up credits，按 Cloudflare 当前界面与费用说明自行付款。
完成后检查：付款入账后再同步。本站不代为充值、不更改自动充值或付款方式，也不存储接口返回的银行卡信息。
9. 安全更换或停用
需要更换时，按步骤三至五创建新的专用只读 Token，使用新的 Account ID 与 Token 在本站添加替代连接。确认同步成功后，从所有引用它的项目移除旧连接，到连接管理删除不再使用的旧连接，最后在 Cloudflare 撤销旧 Token。若当前套餐没有空余连接名额，先规划替换窗口，不要为测试直接撤销线上凭据。
完成后检查：没有撤销其他应用的生产凭据。仅从一个项目移除连接，不等于 Cloudflare Token 自动失效；停止监控后仍需自行撤销不再使用的专用 Token。

Quota Monitor 读取的 Cloudflare AI Gateway 数据范围

只包含通过 Unified Billing 支付的 AI Gateway Credits。BYOK 由原供应商直接计费，其账户余额不在这里；Workers AI 仅在通过 Gateway 使用 Unified Billing 时消耗这笔 Credits，其他计费路径不在本查询范围。
多个 Gateway、Key 或本站项目可能共用同一账户的 Credits，不应把相同余额重复相加。零余额或负余额也不能单独判断 BYOK 或其他计费模式能否调用。
显示最近一次成功查询快照，不保证上游扣费实时入账。保留官方负数；失败不显示为零，也不从充值记录或消费推算余额。
金额单位依据 Cloudflare 官方 cloudflare-os 示例中的旧路径实现；公开新路径的单位说明和真实账户对账仍待验证。首次请与 Credits Available 核对；若出现 100 倍差异，请暂停使用该金额作资金决策并反馈，不要手动改汇率。
看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Cloudflare AI Gateway 常见问题与排查

401、403 或同步被拒绝？: 检查完整 Token 是否有效、过期或撤销，Account ID 是否匹配，权限是否为目标账户的 AI Gateway Read，以及服务端 IP 是否符合 Token 策略。模型调用成功不证明余额权限有效；不要通过改用 Global API Key、Cookie 或全账户权限排错。
为什么是零、负数，或与其他 Cloudflare 费用不同？: 这里只查询 Unified Billing 的 Credits。BYOK 和独立 Workers AI 账单不包含在内；Cloudflare 允许出现待结算的负 Credits，因此保留负值。请在相同账户的 Credits Available 对账，不将充值实付金额当余额。
金额看起来相差 100 倍？: 公开新接口未注明金额单位，目前参考官方旧路径示例按美分除以 100 展示美元，尚待真实账户核验。请暂停以此金额设置资金决策，反馈查询时间与脱敏控制台金额；本站不会按数值大小自动猜单位或改用估算余额。
为什么多个项目显示相同余额？: 同一 Account ID 的 AI Gateway 共用账户级 Credits。本站项目只是业务分组，不会在 Cloudflare 创建独立钱包；不要重复汇总同一账户资金。
充值后同步失败或金额暂未变化？: 先确认付款已入账、账户一致，并查看最近一次成功同步时间。429 表示需稍后重试，接口不可用或格式变化会明确失败而非显示零；刷新不能加速 Cloudflare 的结算。无需为排查公开 Token。

Cloudflare AI Gateway 官方资料

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。