创建只读 Key 失败或 403？

让已有管理员确认创建操作使用正确项目的管理凭据，返回的新 Key 只有 billing:read。普通 member 或语音调用权限不等于财务读取权限。不升级监控 Key 为 admin/owner，也不要提交临时管理 Key 绕过。

401、404 或 Project ID 不匹配？

检查 Key 是否到期/撤销、创建者是否仍在项目，Project ID 是否来自同一 Deepgram 项目。粘贴完整 Key，不要 Token 前缀；本站项目 ID、API Key ID、Cookie 或临时语音 JWT 都不能替代。

有多笔余额，为什么不是第一笔或月度费用？

项目可返回多条 balances，本站对全部不同 ID 的 USD amount 精确相加，不从月费用推算；20 + 4.5 显示 $24.5。不推断现金/赠金类别、适用范围或到期时间，也不跨项目汇总。

空列表、币种不符或与控制台不同？

空列表、重复 ID、非 USD 项、缺失值和错误响应会让整次查询失败，不给出部分和或零值。先核对项目与上次成功时间，旧快照会保留；检查官方入账和合同限制。仅反馈脱敏错误与时间。

429、同步失败，或必须使用区域端点？

429 稍后重试，不连续点击。本站固定使用 api.deepgram.com 全球管理端点，不提供区域驻留保证或自建地址；如组织禁止该流向，请不要提交凭据。充值、语音调用和权限修改均在本站监控范围之外。

Deepgram 余额查询与 billing:read API Key 接入教程

待真实账号验证

教程更新2026-10-11

依据官方项目余额与权限资料实现，待真实账号验证。尚未登录验收权限创建、控制台路径或金额对账，自动测试不代表真实验收。

所需凭据: Deepgram API Key
监控币种: USD · 美元
可以看到什么: Deepgram 项目 Credits 余额; GET https://api.deepgram.com/v1/projects/{project_id}/balances 返回的全部不同 balance_id 的 USD amount 精确相加；不是按使用量估算。资金由同一 Deepgram 项目的多个 Key 和语音服务共享，不是 Quota Monitor 项目的独立钱包。

如何不接入监控，手动查询 Deepgram 余额？

登录 Deepgram Console，使用左上 Projects 选择实际付费项目。
打开该项目 Billing，核对 USD Credits，不拿月费用、价格表或其他项目赠金作比较。
余额不足时在官方付款并确认入账；其他项目分别检查，不把共享 Key 的余额重复计算。

打开官方控制台

在 Quota Monitor 中接入 Deepgram

1. 选择实际付费的 Deepgram 项目
登录 Deepgram Console，在左上 Projects 切换到实际运行语音应用的项目，查看其 Billing 余额。无需为监控新建 Deepgram 项目。
完成后检查：项目名称及 USD Credits 正确；余额属于这个 Deepgram 项目，而不是所有账号项目合计。后续登录界面路径仍待真实账号核验。
打开 Deepgram Console（在新标签页打开）
2. 由已有管理员准备一次性创建权限
请目标项目已有管理员操作。若没有可用管理凭据，在同一项目 Settings → API Keys → Create a New API Key，名称填 Quota Monitor setup，Permissions 选 Admin，Expiration 选短有效期，再 Create Key。复制一次显示的完整值后点 Got it。
完成后检查：这把临时 Admin Key 仅供您本机创建只读 Key，权限较广，绝不能提交给本站、Agent 或在线请求调试站。没有管理权限时请已有管理员代办，不扩大自己的角色；现有业务 Key 保持不变。
官方 Key 创建步骤（在新标签页打开）
3. 获取准确 Project ID
如控制台已显示 Project ID，复制它。否则在本机 HTTP 客户端（关闭云同步和请求日志）新建 GET 请求到 https://api.deepgram.com/v1/projects，请求头 Authorization 填 Token 加一个空格及上一步的管理 Key，无请求体。
完成后检查：在响应 projects 数组按 name 找到目标项目，复制其 project_id；重名时让管理员确认，不直接取第一项。这不是本站项目 ID 或 API Key ID。此请求仅用于一次性准备，本站同步不需要 project:read。
官方 List Projects 响应（在新标签页打开）
04
4. 创建仅 billing:read 的专用 Key
仍在该本机客户端新建 POST 请求，URL 为 https://api.deepgram.com/v1/projects/PROJECT_ID/keys，把 PROJECT_ID 替换为刚复制的值。Authorization 仍用临时管理 Key 的 Token 请求头，Content-Type 设 application/json；请求体选原始 JSON，粘贴下方内容后发送一次。
完成后检查：成功响应含新 key，scopes 仅为 billing:read。不要沿用官方示例的 usage:write/keys:write，也不要将 admin/owner 加到此 Key。将新 key 存入密码管理器；该最小权限流程仍待实测，若被拒绝先联系管理员核对，不提交管理 Key 替代。
创建只读 Key 的请求体 JSON
```
{
  "comment": "Quota Monitor",
  "scopes": ["billing:read"]
}
```
复制的是完整 JSON，不含密钥或账号信息。
官方 Create Key API（在新标签页打开）
5. 验证只读 Key，清理临时管理 Key
新建 GET https://api.deepgram.com/v1/projects/PROJECT_ID/balances，将 Authorization 改为 Token 加新生成的 billing:read Key，无请求体。确认返回 balances，每项含 balance_id、amount 和 USD（或 usd）units。
完成后检查：新 Key 能读余额后，在 Settings → API Keys 删除仅用于本次配置的 Quota Monitor setup 管理 Key，并清理本机请求中的旧凭据。不要删除其他业务 Key。空列表或 403 不证明余额为零，先按下方排错处理。
官方项目余额接口（在新标签页打开）
6. 在 Quota Monitor 项目内添加连接
回到目标项目 → 添加供应商连接 → 新建连接，选择 Deepgram（美元），填可辨认的名称。在 Deepgram Project ID 中填目标 ID，在 Deepgram API Key 中填只读 Key，然后保存。
完成后检查：只粘贴密钥本体，不含 Token/Bearer 前缀、引号或换行。两项遮蔽输入并一起加密保存，只展示 Key 末四位；不填 URL 或额外筛选。MCP 用户通过安全录入链接填写，不把 Key 发给 Agent。
7. 刷新并核对 USD 余额
等待首次同步或点击「查询最新余额」，检查新的成功时间。与 Deepgram 同一项目 Billing 对账；例如两笔 amount 为 20 和 4.5 USD，应显示 $24.5，而不是 $0.245。
完成后检查：币种、项目、时间一致。多个本站项目引用同一 Deepgram 项目时共享资金，不能相加。若对不上，保留脱敏金额、错误码和时间；不要发送 Key、完整 ID、采购单或原始响应。
返回官方控制台对账（在新标签页打开）
8. 需要补充余额时在官方完成付款
点击卡片「前往平台」，在 Deepgram Console 再次选中目标项目并进入 Billing，由有付款权限的人按官方页面核对金额并完成充值或联系合同管理员。
完成后检查：官方入账后再刷新。接入监控本身不要求充值或开启自动付款；赠金、合同 Credits 可能另有限制，请在官方核对，不用余额代替全部可用性判断。
官方项目资金说明（在新标签页打开）
9. 更换、停用与撤销监控 Key
需换钥时按上面步骤生成新的 billing:read Key，创建替代连接并验证，再移除旧连接的项目引用、删除旧连接，到 Deepgram 的目标项目 Settings → API Keys 找旧专用 Key，点其删除图标。
完成后检查：只撤销对应监控 Key，不动在线业务 Key。删除本站连接不会撤销 Deepgram Key；成员被移出项目也可能令其创建的 Key 失效。记录到期时间并按需轮换，名额不足时先安排更换窗口。
官方 Key 与成员管理（在新标签页打开）

Quota Monitor 读取的 Deepgram 数据范围

仅请求全球管理端点 api.deepgram.com，不接收自定义地址，不回退到其他区域。如凭据或财务元数据必须留在特定区域，请暂不连接；不上传音频或转录内容。
不拆分现金、赠金、合同限制或到期时间；账面 Credits 不是可提现现金，不代表所有模型、语音服务或后付费授信均可用。同一上游项目的余额不可重复累加。
单位原本就是 USD，不除以 100，也不再扣减费用。零值和负值保留；空列表、缺失字段、重复余额 ID、非 USD 币种或失败均不当成零，不发布部分余额。
金额是最近成功查询的官方快照，不保证计费零延迟。本站不创建上游 Key、不发起语音调用、不充值、不修改付款配置；以下一次性 Key 创建由您或已有管理员自行完成。
看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Deepgram 常见问题与排查

创建只读 Key 失败或 403？: 让已有管理员确认创建操作使用正确项目的管理凭据，返回的新 Key 只有 billing:read。普通 member 或语音调用权限不等于财务读取权限。不升级监控 Key 为 admin/owner，也不要提交临时管理 Key 绕过。
401、404 或 Project ID 不匹配？: 检查 Key 是否到期/撤销、创建者是否仍在项目，Project ID 是否来自同一 Deepgram 项目。粘贴完整 Key，不要 Token 前缀；本站项目 ID、API Key ID、Cookie 或临时语音 JWT 都不能替代。
有多笔余额，为什么不是第一笔或月度费用？: 项目可返回多条 balances，本站对全部不同 ID 的 USD amount 精确相加，不从月费用推算；20 + 4.5 显示 $24.5。不推断现金/赠金类别、适用范围或到期时间，也不跨项目汇总。
空列表、币种不符或与控制台不同？: 空列表、重复 ID、非 USD 项、缺失值和错误响应会让整次查询失败，不给出部分和或零值。先核对项目与上次成功时间，旧快照会保留；检查官方入账和合同限制。仅反馈脱敏错误与时间。
429、同步失败，或必须使用区域端点？: 429 稍后重试，不连续点击。本站固定使用 api.deepgram.com 全球管理端点，不提供区域驻留保证或自建地址；如组织禁止该流向，请不要提交凭据。充值、语音调用和权限修改均在本站监控范围之外。

Deepgram 官方资料

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