教程更新
依据官方文档实现，真实账号验收待完成。尚未登录验证建 Key、user_read 权限、2FA 兼容性或控制台金额；自动测试和部署成功不等于真实账号通过。
- 所需凭据
- Vast.ai scoped API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 账户 Credits · 美元
- 固定 GET https://console.vast.ai/api/v0/users/current/，Bearer Key 选择个人或团队账号（scope=account）。认证文档与官方 CLI 使用 credit，Show User 参考使用 balance；直接读取美元余额，两个字段同时出现必须精确一致。个人与团队各有独立资金。
不提供 Key，手动查看 Vast.ai 余额
- 登录实际付款身份，打开 Billing；先确认当前是个人账号还是目标团队。
- 读取账户 Credits / balance，不与主机收入、发票合计或其他团队的资金混淆。
- 如需补充资金，由你在官方页面核对账号和金额后操作；确认入账。手动查账不需要把 Key 或验证码交给 Quota Monitor。
在 Quota Monitor 中接入 Vast.ai
确认个人或团队付款账号
打开官方 Billing 页面并登录日常付款身份；如果使用团队，先在控制台切换到实际支付 GPU 费用的团队，再查看余额。
完成检查：能区分个人余额与团队余额。接入监控不要求先充值、租用实例或生成内容。
评估 user_read 的读取范围
打开 API Keys，计划为 Quota Monitor 创建独立 Key。官方把 Show User 放在 user_read；仅有 billing_read（发票和收入）不足以查询这里的余额。
user_read 还允许读取 API Key、SSH Key、环境变量等资料。不能接受这项读取范围时停止接入，用下方手动查询；不要选择默认全权限或新增写权限。
准备可复制的权限配置
复制下方完整 JSON。若用官方 CLI，将它保存为本机新文件 quota-monitor-vast.json；内容没有密钥。它只选 user_read，不含 instance_write、user_write、billing_write 或 misc。
这是官方文档列出的最小相关权限类别，不是仅查余额的精细动作策略；不要自行猜测内部动作名。控制台如果使用勾选项，按相同范围只选择 user_read。
user_read · 账户读取权限（非余额专用）
{ "api": { "user_read": {} } }复制的是完整 JSON，不含密钥或账号信息。
创建专用 scoped Key
在 API Keys 点击 + New，填写便于辨认的名称（如 Quota Monitor balance），把权限从默认全选改为仅 user_read，确认后点击 Create。不要修改已有业务 Key。
如果使用已经安全配置好的官方 CLI，可执行 vastai create api-key --name "Quota Monitor balance" --permission_file quota-monitor-vast.json。只在自己的终端操作；若界面或权限行为与教程不符，先停止并向官方核实，不退回全权限。
保存秘密值并添加本站连接
创建结果显示时把完整秘密值保存到密码管理器；关闭后无法再次查看则需重新创建。保存的是秘密值，不是名称、ID、遮蔽后缀或 Bearer 请求头。
返回 Quota Monitor，进入目标项目 → 添加供应商连接 → 新建连接 → Vast.ai（USD），填写可辨认的连接名，将 Key 填入密码框后保存。无需账号 ID、项目过滤或自定义地址；不要发送 Key 到聊天、URL 或截图。
完成首次同步和金额核对
等待首次同步，或在冷却结束后刷新一次。检查成功时间，再与同一个个人或团队账号的 Billing 金额比较；credit=25 或 balance=25 都显示 $25，而不是 $0.25。
两个字段同时返回时必须精确一致；不一致属于错误。REST/MCP 的 vastBalance 与页面来自相同快照，不再次扣用量。官方界面可能四舍五入，比较时注意查询时间与显示精度。
余额低时回到官方平台处理
卡片的 Open provider 打开官方 Billing。先确认当前登录账号与连接所属个人/团队一致，再由有权限的人决定是否付款；本站不代充值或转账。
供应商余额会随计算、存储等持续变化。停止实例不一定停止存储费用；监控不会操作实例。金额入账后再刷新，遇到 2FA 要求不要关闭安全保护。
轮换或停止专用监控 Key
日常轮换时创建权限相同的新专用 Key，通过本站安全表单更新原连接并确认同步，再在 Vast.ai 撤销旧监控 Key；疑似泄露时应立即撤销。
移除项目关联不等于撤销上游 Key；其他项目仍可能使用同一连接。停止全部监控时分别处理本站连接和上游专用 Key，不分享完整响应或秘密值。
Quota Monitor 读取的 Vast.ai 数据范围
- 25 表示 $25，不是美元分或模型次数。不减 usage、账单或预估费用；不把主机收入、保证金、银行卡额度或项目预算加进来。
- 同账号多个 Key 与本站项目共用资金，不重复求和。团队有独立余额；本站不根据账号 ID 切换团队，也不创建团队或转移资金。
- 零和负数保留原值；缺失、冲突、格式错误或同步失败保留上次成功快照和时间，不造零。查询时间不是结算保证，余额也不保证实例或模型可用。
- 只执行账户信息读取，丢弃邮件、API Key、SSH Key 等非余额字段，不列举其他资源。没有创建实例、调用模型、转账、充值或修改权限的功能。
- 启用 2FA 的账号可能要求额外认证会话，当前不支持这种方式。不要为接入关闭 2FA，也不要提交验证码、恢复码或 TFA 会话；请向 Vast.ai 确认安全的长期 API 方案，或手动查询。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
Vast.ai 常见问题与排查
- 401 或 403 怎么办？
- 先核对 Key 完整、未撤销，且只授予所需 user_read；billing_read 不替代它。若官方要求 2FA 会话，当前连接方式不支持。不要关闭 2FA、提交验证码/TFA 会话或扩大权限；保持手动查询并向官方核实。
- 为何与其他页面金额不同？
- 对比同一个个人或团队的 Billing。主机收益、充值历史、发票总额和其他团队不是这个余额；切换团队后创建的 Key 可能属于不同账号。不要为测试创建或删除团队。
- 零或负数是否说明实例一定不可用？
- 它是官方资金数值，不是可用性测试。停止实例后存储仍可能扣费，其他访问条件也独立；本站不会尝试租 GPU 验证，更不会补零或把负数截断。
- credit 与 balance 冲突，或提示 invalid_response？
- 官方资料存在两个字段名，本站支持任一；同时出现时要求精确一致。缺失、null、格式错误或含错误信号会失败并保留旧时间与金额，不猜优先级。
- 429 或同步失败后怎么办？
- 等待冷却后再刷新，查看上次成功时间。网络、鉴权或服务端错误不会写成新零余额；向支持人员只提供脱敏错误码和时间，不提供 Key 或原始账户响应。
- 是否已通过真实账号测试？
- 尚未。你仍需验证个人/团队 Key 的创建、权限及 2FA 行为，再对账页面和 MCP 的美元余额。模拟数据与成功部署不能替代这些验收。
Vast.ai 官方资料
- Show User API · balance 字段（在新标签页打开）
- 官方认证 · credit 与固定请求地址（在新标签页打开）
- 官方权限类别及接口映射（在新标签页打开）
- API Key 创建与轮换（在新标签页打开）
- 官方 CLI · scoped Key（在新标签页打开）
- Billing · 账户资金及存储收费（在新标签页打开）
- 个人与团队独立资金（在新标签页打开）
- 官方 CLI · 2FA 注意事项（在新标签页打开）
- 官方计价（USD）（在新标签页打开）
- Credits 的美元单位（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。