教程更新
已按官方余额 API 实现，待真实账号验证。尚未登录验收 Key 创建、团队权限或金额对账；自动测试不等于真实验证。
- 所需凭据
- Novita API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 账户可用余额
- 读取该凭据所属 Novita 账户的 availableBalance，所有金额由官方的万分之一美元单位精确换算。充值余额、信用额度、待结算费用和未结清欠款独立展示，不重新计算可用余额。团队共享资金不是单个成员、Key 或本站项目的钱包。
不接入监控，如何手动查询 Novita AI 余额？
- 登录业务实际付费的 Novita 账户，确认团队/个人账户选择。
- 打开 Billing，查看美元可用余额和充值资金，分别检查信用额度及欠款。
- 需要充值时在官方账务页自行支付；不把模型/Sandbox 赠金、月消费或 Key 预算当成同一余额。
在 Quota Monitor 中接入 Novita AI
1. 确认账户和余额页面
登录 Novita AI，打开下方 Billing 直达链接；如果加入过团队，先确认当前团队或个人账户就是业务实际付费的一方。查看账户余额，而不是模型专用赠金或 Sandbox 试用额度。
完成后检查：可以找到目标账户的美元余额。仅接入监控无需充值，也无需把个人账户升级为团队。登录后菜单和金额仍待真实账号核验。
2. 打开 Key Management 创建专用 Key
在同一账户进入 Settings → Key Management，点击 Create API Key，将名称设为 Quota Monitor，避免复用其他应用的生产 Key。
完成后检查：正在创建 Novita 的 API Key，不是模型名称、Key ID、其他供应商 Key 或浏览器会话凭据。
3. 选择有效期并保存完整密钥
创建时根据团队策略选择有效期。官方提供 Permanent、90 days、30 days、24 hours；短期测试可以使用 24 hours，长期监控选择符合策略的期限并提前安排换 Key。创建后立即复制只展示一次的完整 sk_ 密钥，保存到密码管理器。
完成后检查：复制的是完整秘密值，没有 Bearer 前缀。有效期创建后不可修改；丢失或到期需要创建新 Key。不要将 Key 放进聊天、截图或教程反馈。
4. 核对权限与限制，不假设只读
这是普通 API Key，不是余额专用只读令牌。需要限制模型时，由已有权限的管理员在该专用 Key 的 Model Access 中选 Selected models only、选择允许的模型并保存；官方要求至少一个模型，该限制也不涵盖独立图像/视频能力，不能因此宣称只读。
完成后检查：未修改其他应用的 Key。团队文档将 Balance 权限授予 Owner、Admin、Billing，但 Billing 角色不能创建模型 Key；具体 Key 的账务访问仍需实测。遇到 403 请让现有管理员核对或询问 Novita，不为监控直接提权，不关闭安全策略。
5. 在项目内添加 Novita 连接
回到 Quota Monitor，打开目标项目 → 添加供应商连接 → 添加新连接，选择 Novita AI（美元）。填写便于辨认的连接名，将完整 Key 粘贴到 Novita API Key 密码框，保存并接入项目。
完成后检查：只需一个 Key，不填 API 地址、团队 ID、供应商项目 ID 或 Key ID；币种固定 USD。密钥加密保存，仅显示末四位。MCP 接入使用安全录入链接，不把 Key 交给 Agent。
6. 同步并与官方余额核对
等待首次同步或点击查询最新余额，确认成功查询时间更新。重新打开相同账户的 Billing，核对可用余额；展开卡片金额说明，分别核对充值余额、信用额度和欠款。
完成后检查：账户、币种和时间一致。官方 API 的 10000 单位等于 1 美元，本站自动换算，无需设置比例；不应与原始整数、月消费或 Key 预算直接比较。真实对账仍待完成，发现差异只提供脱敏金额、时间和错误码。
7. 需要补充资金时前往官方平台
卡片点击前往平台，确认同一账户，在 Billing 的充值入口输入所需金额，按官方当前付款规则自行完成支付；不要把开启自动充值作为接入前提。
完成后检查：支付已入账，再回本站同步。本站只调用余额 GET，不充值、不修改付款方式、自动充值或预算。
8. 到期前更换或停用专用 Key
创建新专用 Key，在本站添加替代连接并确认同步成功，再移除旧连接的全部项目引用、删除不再使用的旧连接，最后回到 Novita Key Management 删除旧专用 Key。没有空余连接名额时先规划替换窗口。
完成后检查：没有删除业务生产 Key。从一个项目移除连接不等于撤销 Novita Key；不再监控时需到官方平台删除不再需要的专用 Key。
Quota Monitor 读取的 Novita AI 数据范围
- 信用额度是可欠款额度，不是已经充值的现金。不要把明细再次相加或扣减，也不要跨项目累加同一账户余额。
- 不查询模型或 Sandbox 专用赠金、代金券、成员/Key 预算和套餐剩余量，也不把它们换算成账户资金。
- pendingCharges 目前按官方文档默认返回 0，不能证明没有未结算消费。显示最近成功查询结果；官方入账可能延迟，失败不补零或估算。
- 正余额不保证所有请求可用；Key 到期、团队权限、模型访问和独立预算仍可能限制调用。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
Novita AI 常见问题与排查
- 401 或凭据格式错误？
- 从同一账户重新复制完整 sk_ Key，移除 Bearer 前缀，检查是否到期或删除。不要用掩码值、Key ID 或 Cookie；完整值只展示一次，丢失就创建新的专用 Key。
- 模型能调用，但余额返回 403？
- 模型与账务权限不同。请现有管理员核对团队和凭据所属成员，必要时联系 Novita 确認余额接口权限。不要直接提高成员角色、关闭限制或改用 Cookie。无法接受普通 Key 风险时使用官方页面手动查询。
- 为什么不是充值金额，或者相差 10000 倍？
- 主金额使用官方 availableBalance；cashBalance 是剩余充值资金，creditLimit 是信用额度。全部 API 字段单位为万分之一美元，本站已换算一次。不要把字段相加、再次除以 10000 或与月账单比较。
- 待结算费用为零，是否没有新消费？
- 不能如此推断。官方文档注明 pendingCharges 当前默认返回 0，它不是完整实时用量证明。以同账户最新账务记录和成功查询时间核对。
- 充值未出现、同步失败或多个项目余额相同？
- 先核对账户和付款入账；429 时稍后重试。失败会保留旧快照，不代表刷新成功，也不会变成零。相同账户资金可由多个 Key/项目共享，不要重复汇总。
Novita AI 官方资料
- 官方余额 API 与 1/10000 USD 单位（在新标签页打开）
- 官方 API Key 创建、格式和有效期（在新标签页打开）
- 官方团队账务与 API Key 权限（在新标签页打开）
- 官方模型访问限制及适用范围（在新标签页打开）
- 官方付款说明（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。