DigitalOcean 全账户预付款查询与 billing:read 令牌接入教程

不托管令牌时人工核对

1. 打开所选团队的 Billing；若属于组织，进入组织的 Billing 标签，确认实际付款账户。
2. 把 account prepayment 与 Inference & Agents balance、促销额度及普通发票/欠款分开查看，不加总团队或项目的重复视图。
3. 若已配置官方 CLI，可用 doctl prepayment status 比较相近时间的 Balance；无需支付、泄露令牌或调用模型。

在 Quota Monitor 中接入 DigitalOcean · 全账户预付款

1. 01

   确认正确的账务上下文

   自行登录 DigitalOcean Control Panel，选择实际业务所属团队。打开 Billing，把 account prepayment、Inference & Agents balance 和普通账单应付金额分开查看。

   若团队属于组织，从头像菜单进入 View Organizations → 选择组织 → Billing，核对共享资金。检查您是否已有财务查看权限，不为监控新建组织、充值或修改 auto-reload。

   打开 DigitalOcean 官方页面（在新标签页打开）
2. 02

   进入个人访问令牌创建页

   在控制台主菜单选择 Account → API，在 Applications & API Tokens 页找到 Personal access tokens，点击 Generate New Token。

   使用独立名称，例如 QuotaMonitorBilling，并设置适当到期时间。本接入需要个人访问令牌，不是推理/模型 Key、Spaces Key、OAuth 访问或刷新令牌、密码或浏览器 Cookie。

   打开 DigitalOcean 官方页面（在新标签页打开）
3. 03

   只选择最小自定义权限

   选择 Custom Scopes，搜索 billing，只勾选 Read（billing:read）；生成前检查已选权限摘要。此端点的官方权限表不要求额外 scope。

   不要选择全局 Read Only 别名 api:read 或 Full Access。billing:read 也能读取其他账单/发票信息，并非余额专用权限。可选权限受现有团队角色限制；缺失时联系现有管理员，不提升监控身份角色。此 UI 流程没有可粘贴的 IAM 策略 JSON。

   打开 DigitalOcean 官方页面（在新标签页打开）
4. 04

   生成并私下保存 PAT

   检查名称、到期时间和权限后点击 Generate Token，私下保存一次性显示的 dop_v1_ 值；不要放进对话、URL、截图、日志或 MCP 参数。

   遗失令牌值时应创建替代令牌，不使用 Cookie 绕过。生成后不能编辑 scope，需有意轮换为新的专用令牌。Quota Monitor 无法仅凭前缀证明最小权限，请自行检查创建摘要。

   打开 DigitalOcean 官方页面（在新标签页打开）
5. 05

   连接账户预付款供应商

   在 Quota Monitor 目标项目中添加连接，选择 DigitalOcean · 全账户预付款，将专用 PAT 填入遮蔽的凭据字段。MCP 安全凭据链接使用同一表单。

   币种固定 USD，没有团队/项目/Key 筛选、端点覆盖或日耗估算。服务端加密保存凭据，其他页面只显示末尾标识；可先打开帮助抽屉阅读本教程，不提交或显示输入。

   打开 DigitalOcean 官方页面（在新标签页打开）
6. 06

   首次成功同步并对账

   刷新后确认成功查询时间更新，在相同账务上下文和相近时间比较 status.balance 与 account prepayment。例如 25.123456789 USD 是美元，不是美分，也不能除以 100。

   若控制台展示分组不同，可在您本地已配置的官方 CLI 执行 doctl prepayment status 并对比 Balance；不要使用 doctl balance 或 AI 专项余额代替。eligible=false 不会使返回余额失效。缺失金额、404 或权限拒绝是错误，不能编造零。

   打开 DigitalOcean 官方页面（在新标签页打开）
7. 07

   分开理解三个状态

   核对 eligible（账户预付款门控资格）、blocked（该门控是否阻止使用）和 is_auto_prepay_enabled（账户自动预付）。未知值保持未知，不能显示为未启用。

   这些不是 AI 钱包的 auto-reload 设置、到期时间或模型可调用保证；还可能有 AI 专项资金或促销额度。Quota Monitor 的阈值只分类此账户预付款，不修改上游支付或限额。

   打开 DigitalOcean 官方页面（在新标签页打开）
8. 08

   安全排错与轮换

   401 时检查 PAT 到期/撤销状态，以及是否输入原始 dop_v1_ 值而非完整 Bearer 请求头。403 时检查 billing:read 与所选账务上下文，不扩大角色。404 或功能不可用时保留人工查看，不猜其他端点；429 和临时故障稍后重试。

   通过安全凭据表单轮换，成功读取后再停用旧监控令牌。不要修改业务凭据、调用收费模型或充值测试。失败会保留上次成功金额及时间，只提供脱敏错误代码。

   打开 DigitalOcean 官方页面（在新标签页打开）

Quota Monitor 读取的 DigitalOcean · 全账户预付款 数据范围

• Inference & Agents balance 是独立的 AI 专项资金；全账户预付款还支付非 AI 云服务。本连接只读取账户预付款，不声称通用账务 API 已能读取 AI 钱包。
• 促销额度、Inference & Agents balance 和账户预付款是三类独立资金，AI 使用时依次扣除。账户预付款为零并不能证明 AI 已无资金或全部云资源已停用。
• 组织下的团队共用组织出资的资金；独立团队有自己的账务上下文。创建 PAT 前选择正确团队，不能把重复连接相加或分摊成项目/Key 余额。
• balance 是美元十进制字符串，保留零、负值与精度。month_to_date_balance 及 /customers/my/balance 是账务数字，不能替代预付款；本连接丢弃这些值，不猜测符号、重置、到期或 AI 剩余天数。
• eligible、blocked、is_auto_prepay_enabled 仅描述账户预付款门控。缺失或 null 表示未返回，不是 false；Quota Monitor 不启用自动充值，也不据此判断模型可用性。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

DigitalOcean · 全账户预付款 常见问题与排查

这就是 DigitalOcean 的 AI 钱包吗？

不是。这是共享的全账户预付款，AI 在其他适用资金后也可使用；独立的 Inference & Agents balance 未查询。普通账单余额和月内费用不会当成钱包资金。

到底需要什么权限，是余额专用的吗？

Custom Scopes 只选 billing:read，官方表没有附加权限。它也可读取其他账单/发票信息，不必使用 api:read 或 Full Access。令牌前缀不能证明权限最小。

为什么多个团队看见相同金额？

组织下的团队共享组织出资资金。请确认实际账务上下文并独立对账，不能把重复视图相加或当作团队专属分配；真实组织行为仍待用户测试。

余额为零或 blocked=true 是否说明 AI 一定不可用？

不能。它仅描述账户预付款门控，可能另有 AI 专项资金或促销额度。模型可用性、重置时间、到期和 AI 剩余天数保持未知。

为什么状态缺失，或者 eligible=false？

官方状态字段是可选的，缺失/null 表示未返回，不是 false。eligible 表示是否适用账户预付款门控体验，不是 AI 额度，也不是丢弃有效余额的理由。

403/404 或金额不一致怎么办？

不扩权地检查现有 scope、到期时间和账务上下文。比较相近时间的账户预付款，不是普通发票或 AI 钱包；支付和用量可能不同步更新。失败或未支持的读取保留旧快照，不归零。

DigitalOcean · 全账户预付款 官方资料

• 官方资料 · docs.digitalocean.com/reference/api/reference/billing/（在新标签页打开）
• 官方资料 · docs.digitalocean.com/reference/api/scopes/billing/read/（在新标签页打开）
• 官方资料 · docs.digitalocean.com/reference/api/create-personal-access-token/（在新标签页打开）
• 官方资料 · docs.digitalocean.com/products/inference/how-to/manage-serverless-inference-prepayment/（在新标签页打开）
• 官方资料 · docs.digitalocean.com/platform/billing/pay-bills/（在新标签页打开）
• 官方资料 · docs.digitalocean.com/reference/doctl/reference/prepayment/status/（在新标签页打开）
• 官方资料 · github.com/digitalocean/openapi/blob/main/specification/resources/billing/models/prepayment_status.yml（在新标签页打开）
• 官方资料 · docs.digitalocean.com/platform/billing/invoices/（在新标签页打开）

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