教程更新
依据官方文档实现，真实账号待验收；仍需用户验证建 Key、权限行为及控制台对账。自动测试不代表真实账号通过。
- 所需凭据
- AI/ML API 普通 API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 账户余额 · 美元
- 固定 GET https://api.aimlapi.com/v2/billing，读取认证账户的 current_balance 与 currency=USD（scope=account）。25 就是 $25。多个 Key 和本站项目可能共享钱包；Key 的 USD limit 不是独立资金。
不提供 Key，手动查看 AI/ML API 余额
- 用实际付款账户登录官方控制台，进入 Billing → Overview。
- 读取总美元余额，不与 Usage 已花费用、Key 的 USD limit 或历史充值合计混淆。
- 需要补充资金时在官方付款流程核对后处理并确认入账；手动查账无需向 Quota Monitor 提供凭据。
在 Quota Monitor 中接入 AI/ML API
确认实际付款账户
打开官方控制台并登录，选择 Billing → Overview，确认这是应用实际使用账户的总美元余额。
完成检查：看到的是账户资金，不是 Usage 已花费用或 API Key 的 USD limit；接入监控无需生成内容或先充值。
选择正确的密钥类型
打开密钥页面，选择 API Keys 而不是 Management Keys。点击 Create API Key，给新建专用 Key 命名，例如 Quota Monitor balance。
保留现有业务 Key 不变。Management Keys 用于管理其他 Key，不是这里要求的凭据；不要提交浏览器 Cookie 或账号密码。
检查权限与托管风险
在新 Key 的 Edit 设置中检查 Endpoint permissions、USD limit 和重置周期；在平台支持时移除不需要的模型权限并点击 Save。消费限制可减少风险，但不会自动变成只读。
官方未定义余额专用权限，也未保证空 scopes 列表禁止推理。不要粘贴猜测的权限策略；无法接受这项不确定性时停止接入，按下方方式手动查账。
安全保存完整秘密值
在新秘密值可见时复制并安全保存。需要完整秘密值，不是名称、ID、遮蔽后缀或 Authorization: Bearer 请求头。
确认专用 Key 所属账户与 Billing 一致。无法再次查看秘密值时创建替代 Key；不要把它放进聊天、URL、工单或截图。
在项目内添加连接
回到 Quota Monitor，打开目标项目 → 添加供应商连接 → 新建连接 → AI/ML API（USD），填写可辨认的名称，把秘密值粘贴到遮蔽的 API Key 输入框并保存。
无需自定义地址、账户 ID 或项目/Key 过滤。本站项目只是监控分组，不会在 AI/ML API 创建独立钱包。
完成首次同步对账
等待首次同步，或冷却结束后刷新一次。检查成功查询时间，再比较同账户 Billing → Overview：current_balance=25 且 currency=USD 应显示 $25。
REST/MCP 的 aimlapiBalance.balance 保留同一快照的精确十进制金额。不要与 Key 限额比较；两次查询期间的活动和官方页面四舍五入可能影响显示。
余额低时前往官方处理
通过卡片 Open provider 进入控制台，再选择 Billing → Overview；确认当前登录账户后，由有权限的人决定是否使用 Top up。
本站不会充值或配置自动充值。供应商确认资金入账后再刷新；正在执行的任务与付款处理可能影响新金额出现的时间。
轮换或停止监控
日常轮换时创建新的专用 Key，经安全表单更新原连接并确认同步，再禁用或撤销旧监控 Key；疑似泄露时应立即撤销。
移除项目关联不等于撤销上游 Key，其他项目可能仍共享连接。分别处理供应商 Key 和本站连接，不误删业务凭据。
Quota Monitor 读取的 AI/ML API 数据范围
- v2 已返回美元，不按 Credits 比例换算、不再次减用量、不重复累加同账号余额；不使用 legacy /v1/billing/balance。
- 只执行一次余额读取，不读取详细账务、交易流水、模型内容或密钥管理，不调用模型、修改权限或付款。
- 官方零和负数保留原值。缺失币种、格式错误或同步失败保留上次成功快照与时间，不造零。
- observedAt 是查询时间，不是结算保证；进行中的异步任务与付款入账可能影响后续金额。账户有钱不保证某个模型或 Key 可调用。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
AI/ML API 常见问题与排查
- 401 或 403 怎么办？
- 确认普通 API Key 完整、有效且属于目标账户。不要改用 Management Key、Cookie 或为了绕过错误扩大权限；检查官方文档，必要时手动查账。
- Key 限额为什么和余额不同？
- Key 限额限制该 Key 的花费；current_balance 是多个 Key 共享的账户资金。Key 达到限额时即使账户还有钱也可能不可调用；本站不扣减限额或把它称为余额。
- 为什么出现 invalid_response？
- 必须同时返回 current_balance 和 currency=USD。旧版仅 balance 的响应、null、错误数字或错误信号都会被拒绝；不会猜换算比例或重试旧版/私有端点。
- 429 或刷新失败后怎么办？
- 等待冷却并检查上次成功时间。失败会保留旧金额与旧时间，不会变成新零余额。只反馈脱敏错误码和时间，不提供 Key 或原始响应。
- 为什么控制台金额不同？
- 在相近时间比较同账户 Billing Overview。进行中的任务、付款入账与显示精度可能不同；不要比较发票、Key 限额或其他账户，也不要用收费模型测试。
- 真实账号是否已经通过？
- 尚未。请验证建 Key 与权限步骤，再比较一次成功同步及 REST/MCP 金额与官方控制台。部署成功和模拟响应不能替代真实验收。
AI/ML API 官方资料
- 官方 v2 余额字段与 legacy 区分（在新标签页打开）
- 官方 API Key 创建及权限说明（在新标签页打开）
- 官方入门 · Billing、Key 设置与排错入口（在新标签页打开）
- 官方 Key 管理 · 普通 Key 与 Management Key（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。