ModelsLab 余额查询与只读钱包令牌接入教程

不向本站提供令牌时手动查看

1. 打开 modelslab.com 自行登录，确认是实际 API 计费账户。
2. 进入账户 Dashboard 找 USD 钱包/余额区域，对比钱包资金，不看套餐额度、剩余请求次数或模型用量。
3. 私下记录金额与时间；后台布局或账户范围不明确时联系 ModelsLab 官方。无需向本站提供 Key、密码、Cookie，也无需充值或创建连接。

在 Quota Monitor 中接入 ModelsLab

1. 01

   先确认账户和钱包

   打开下方 ModelsLab 官网，自行登录实际承担 API 费用的账户。在账户 Dashboard 找到钱包/余额区域，记下 USD 钱包金额和当前账户，不与套餐用量混淆。

   本文使用您自己的邮箱/密码向官方申请控制平面令牌。只有 Google/SSO 登录且无法使用该公开流程时，先手动查账或联系官方获得限定权限令牌，不提取浏览器 Cookie，也不改账户权限。

   打开 ModelsLab 官网（在新标签页打开）
2. 02

   准备私有的本地 HTTP 请求

   使用自己控制的本地 HTTP 客户端，为本次操作关闭云同步、共享工作区、请求历史和日志。新建请求：方法 POST，URL 为 https://modelslab.com/api/agents/v1/auth/login，不设置 Authorization，Content-Type 为 application/json，并关闭跟随重定向。

   请求体选择 raw JSON，复制下方配置。这是您在本地直接向 ModelsLab 申请凭据的步骤，不是 Quota Monitor 发起的登录。如果无法保证请求隐私，请停止并手动查账。

   最小令牌配置 · 登录字段只在本地添加

   复制 JSON

   {
     "device_name": "QuotaMonitorReadOnly",
     "token_expiry": "1_month",
     "scopes": [
       "wallet:read"
     ]
   }

   复制的是完整 JSON，不含密钥或账号信息。

3. 03

   只申请 wallet:read

   保留可复制 JSON 中的 device_name=QuotaMonitorReadOnly、token_expiry=1_month 和 scopes=[wallet:read]。在同一个 JSON 对象中本地添加 email、password 两个字符串字段，填写您自己的 ModelsLab 登录信息；使用客户端 JSON 编辑器正确转义引号。

   确认目标域名精确为 modelslab.com 后发送一次。省略 scopes 会授予 *，不能删除或加入 wallet:write、billing:write、tokens:write。请求一个月有效期可能被账户策略缩短；本文不要求充值或购买订阅。

4. 04

   核对并只保存 access_token

   成功响应应为 error=null 且有 data.access_token。确认 data.scopes 恰好为 wallet:read，检查 data.expires_at 和 token_lifetime_capped，并私下设置到期提醒。权限缺失或比所请求更宽时不要接入，联系官方。

   只复制 data.access_token，不是 data.api_key（ml- 生成 Key）、整段 JSON 或 Bearer 文字。妥善保存后丢弃本地请求/响应及凭据历史，不向聊天发送截图、密码、令牌或完整响应。

5. 05

   在项目内添加连接

   在 Quota Monitor 打开目标项目，添加供应商连接并选 ModelsLab，填写易识别的名称，只把访问令牌粘到遮蔽凭据框后保存。MCP 用户通过安全录入链接填写，不把令牌发给 agent。

   币种固定 USD，上游项目/Key 筛选留空，不需要账户 ID、自定义域名或账户切换。共享钱包的项目优先复用已有连接，保存前核对平台及账户。

6. 06

   等待首次成功同步

   等待自动同步，或遵守页面冷却提示手动查询一次。成功判据是新的成功查询时间和钱包金额，看到旧金额不代表本次查询成功。

   服务端只以 Bearer 认证调用固定 GET，无请求体、Cookie 或重定向，不使用登录密码。令牌到期后 401 需要手动更换凭据，不能猜为零余额。

7. 07

   按同一账户美元钱包对账

   回到同一账户后台的钱包/余额区域，把 USD 钱包金额、观察时间与 modelslabBalance.balance 对比。官方示例 data.balance=75.50、currency=USD 应显示 $75.50，套餐额度、API 用量和产品订阅不是这笔钱包资金。

   不一致时先检查账户上下文与账务时间，再等待上游结算后重试。不要为测试增加账户、切换令牌上下文、重复充值或调用收费模型；完成对账前保留待实测状态。

   打开 ModelsLab 官网（在新标签页打开）
8. 08

   到期前更换，只撤销旧令牌

   expires_at 前重复最小权限登录步骤，在本站安全表单更换凭据，确认余额读取成功。令牌不会自动续期，删除本站连接也不等于在 ModelsLab 撤销。

   停用旧令牌时，在私有本地客户端发送 POST https://modelslab.com/api/agents/v1/auth/logout，Authorization 为 Bearer 后接该旧令牌，关闭重定向。官方自撤销不需要额外 scope；不要使用 logout-all 或影响其他令牌，完成后丢弃凭据历史。

Quota Monitor 读取的 ModelsLab 数据范围

• 套餐额度与钱包资金独立，不扣减使用量、不加套餐、不换汇、不汇总团队或估算余额。多个连接可能对应同一笔资金，不要相加。
• 本站不登录、不刷新令牌、不切换账户、不调用模型、不充值或修改权限。钱包有余额不保证订阅或指定模型可用。
• REST/MCP 的 modelslabBalance.balance 保留精确小数字符串。零和负值照实显示；主金额缺失/null、非 USD、业务错误或查询失败时保留旧成功快照及时间。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

ModelsLab 常见问题与排查

401 或令牌过期？

检查 expires_at、是否撤销和令牌类型，重新按 wallet:read 私下登录申请，再在安全表单替换 access_token，不填 ml- 生成 Key 或密码。

403 或 insufficient_scope？

检查令牌包含 wallet:read 且账户邮箱已验证。省略 scopes 获得全权限并不是更安全的修复；不要加写权限或切账户排错，改用手动查看或联系官方。

只有 Google 登录或无法获得限定权限令牌？

本文不替您交换 Google ID token 或创建密码。先手动查询，向 ModelsLab 确认该账户可用的最小权限流程，不复制浏览器会话凭据。

为什么钱包与套餐额度不同？

订阅额度是独立资源，可能随账期重置。本站只读取钱包，不读取剩余套餐次数、Key 限额或总体消费能力，钱包低不代表所有模型均被阻止。

两个项目为什么金额相同？

项目只整理监控，不会创建上游钱包。多个令牌可以共用账户资金，不重复汇总。切换网页账户也不意味着旧令牌上下文跟着变化。

404、429、5xx、null 或币种错误？

检查最新同步错误和时间，等待限流/故障恢复，持续失败联系官方。只接受 USD 和有效成功响应；旧数据保留原查询时间，不修改目标 URL 或猜为零。

ModelsLab 官方资料

• 官方钱包余额端点及 USD 示例（在新标签页打开）
• 最小权限 scopes 与自撤销规则（在新标签页打开）
• 登录、令牌有效期与账户策略（在新标签页打开）
• 控制平面与生成模型凭据区别（在新标签页打开）
• 钱包资金与套餐额度区别（在新标签页打开）

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