教程更新
已按官方 GraphQL 与 CLI 资料实现，待真实账号验证。尚未登录验收新建只读 Key、团队权限或余额对账；自动测试不等于实测。
- 所需凭据
- Runpod API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 账户 Credits 余额
- 固定 POST https://api.runpod.io/graphql，仅查询 myself { clientBalance }。原值已是 USD，由凭据所属预付账户的 Pods、Serverless 和存储共享；不是单个项目、Pod、端点或 Key 钱包。
不接入监控，如何手动查询 Runpod 余额？
- 登录实际付费的 Runpod 个人或团队账户。
- 打开 Billing，查看账户 USD Credits，而不是每小时支出、spendLimit 或主机收益。
- 确认需要补充时在官方支付并等待入账；企业后付费账户应核对账单，不适用预付余额。
在 Quota Monitor 中接入 Runpod
1. 确认实际付费账户与计费模式
登录 Runpod，打开下方 Billing 链接，确认个人或团队账户与实际运行应用的账户一致。团队成员若无法查看财务，请找已有 Billing/Admin 权限的人核对，不要为监控扩大自己的角色。
完成后检查：能在目标账户看到 USD 预付余额。企业 post-paid 账户不显示这种余额，本教程不适用；无需先充值，也不用把个人账户升级为团队。
2. 进入 API Keys 并创建专用 Key
在同一账户打开 Credentials，选 API Keys 页签，再点 Create API Key。名称填 Quota Monitor，便于与其他业务使用的 Key 区分。
完成后检查：当前是 API Keys，而不是 S3 API Keys、SSH 或登录会话。不要修改已经用于在线业务的密钥；实际登录后的界面与团队授权仍待实测。
3. 选择只读权限，不使用旧版 Key
在权限中选择 Read Only，再点击 Create。不要选 All。Read Only 并非余额专用权限，可能还可读取其他账户资源；若团队必须使用 Restricted，由已有管理员按官方权限设置限制访问，不随意开启推理或写权限。
完成后检查：这是新建的独立 Key。2024-11-11 前创建的 legacy Key 即使 GraphQL 标为只读，也可能调用收费 AI API，应换成新的专用凭据。只读余额权限的真实可用性仍须核验。
4. 复制并妥善保存完整密钥
点击新生成的 Key 复制完整值，存入密码管理器。只保存密钥值，不带 Bearer 前缀、引号、空格或换行；不是 Key 名称或掩码末尾几位。
完成后检查：已安全保存完整值且未放入聊天、截图或工单。完整值遗失时重新创建专用 Key；不要从浏览器抓取 Cookie 或会话令牌代替。
5. 在目标项目中添加 Runpod 连接
回到 Quota Monitor，打开项目 → 添加供应商连接 → 新建连接。选择 Runpod（美元），填写可辨认的连接名称，在 Runpod API Key 密码框中粘贴完整密钥并保存。
完成后检查：无需 API 地址、Pod ID、Team ID 或 Key ID，币种固定 USD。密钥加密保存，只展示末四位；通过 MCP 接入时使用安全录入链接，不把密钥发给 Agent。
6. 查询并与官方余额核对
等待首次同步，或点击「查询最新余额」，确认成功查询时间已更新。回到同一账户 Billing 核对金额：clientBalance 为 24.5 时应显示 $24.5，而不是 $0.245 或每小时费用。
完成后检查：账户、币种与时间一致。同一账户的多个项目会共用余额；不要累加。测试反馈仅提供脱敏金额、查询时间和错误码；当前真实余额对账仍待完成。
7. 余额不足时前往官方补充 Credits
在卡片点击前往平台，再次核对 Billing 所属账户；确需充值时，由有付款权限的人选择美元金额或 Other，自行核对并完成支付。
完成后检查：官方入账后再刷新本站。无需启用自动充值来完成接入；本站只发只读 GraphQL 查询，虽使用 POST，但不执行任何 mutation、付费调用或支付操作。
8. 更换或撤销不再使用的专用 Key
需要更换时，新建同权限 Key，建立替代连接并验证成功，再移除旧连接的所有项目引用并删除旧连接。到 Runpod Credentials → API Keys 找到旧的专用 Key，点删除图标并确认 Revoke Key。
完成后检查：其他业务 Key 未被撤销。项目中移除连接不等于在 Runpod 撤销密钥；名额不足时先规划更换窗口。只想临时停用，可在官方该 Key 的开关中确认 Yes。
Quota Monitor 读取的 Runpod 数据范围
- 仅面向有 Billing 余额的预付账户；企业后付费不支持。本接口不判断账单模式，请先确认账户类型。
- 不读取 hostBalance、付款资料或邮箱；每小时 spendLimit 不是月限额。不按小时费用预估余额，也不重复扣减用量或跨项目累加同一账户的钱。
- 显示官方最近成功查询值，不保证零入账延迟；零值和负值保留，失败不伪造余额。正余额也不保证资源可用。
- Credits 不是可提现现金；赠金、优惠和成本中心不另做拆分。接入不启动/停止资源，不充值，不修改支付方式或限额。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
Runpod 常见问题与排查
- 401 或凭据格式错误？
- 检查完整 API Key、账户、停用或撤销状态，去掉 Bearer 前缀和换行。S3 密钥、SSH 密钥、Cookie、Key 名称和掩码值都不能替代。遗失完整值时新建专用 Key。
- 403 或 GraphQL 查询失败？
- 让已有管理员确认凭据来自正确账户且有 Read Only 查询权限。团队 Billing 可读财务，Basic/Dev 角色不可，但这不自动保证 Key 的权限。不要升级为 All 来绕过错误。HTTP 200 也可能含 GraphQL errors，本站拒绝部分数据并保留旧成功快照。
- 余额为什么与小时费率、spendLimit 不同？
- clientBalance 是 USD 账户余额；spendLimit 是每小时上限，currentSpendPerHr 是每小时费用，两者都不是剩余资金。24.5 就是 $24.5；不再除以 100，不从余额重复减费用。
- 多个项目显示一样，或企业账户没有余额？
- 同一预付账户共享 Credits，项目只做业务分组，不能重复加总。企业 post-paid 无预付余额，本版本不支持；不要把返回的零值误认成企业欠费。
- 充值未到账、429 或同步失败？
- 核对实际付费账户、官方入账和上次成功时间；429 稍后重试。空数据或错误不视为零，失败不覆盖旧余额。官方计费有更新周期，金额不保证工作负载能启动；请仅提供脱敏错误码和时间，不发送密钥。
Runpod 官方资料
- 官方 GraphQL myself 与 clientBalance 字段（在新标签页打开）
- 官方 CLI 账户余额示例（在新标签页打开）
- 官方 API Key 创建、权限与旧版风险（在新标签页打开）
- 官方账户 Credits 与每小时上限（在新标签页打开）
- 官方团队角色与财务访问（在新标签页打开）
- 官方企业后付费的不同计费模式（在新标签页打开）
- 官方 CLI GraphQL 地址与 Bearer 认证实现（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。