教程更新
依据官方文档实现，待真实账号验证；未登录走通创建 Key、Admin 权限与控制台逐项对账。自动测试不能替代真实验收。
- 所需凭据
- Venice Admin API Key
- 监控币种
- USD · DIEM 与其他额度单列
- 可以看到什么
- 账户美元余额
- 固定 GET https://api.venice.ai/api/v1/billing/balance 读取认证账号余额。主金额是 balances.usd，单位已是美元（scope=account）；DIEM、bundledCredits、earnedCredits 分别显示，多个项目与 Key 可能共用这些资金。
不共享 Key，直接查看 Venice 余额
- 登录实际承担 API 费用的账号，进入 Settings → API。
- 分别读取 USD、DIEM、套餐与奖励额度，不拿单 Key 消费上限替代账户余额。
- 需要入金时在 Venice 自己的支付流程确认账号与金额，确认到账后再使用；无需向本站提供 Key。
在 Quota Monitor 中接入 Venice AI
确认支付 API 费用的账号
用实际支付 API 费用的 Venice 账号登录，从下方链接进入 Settings → API。找到 USD 余额，将 DIEM 与套餐相关额度分开看。
完成检查：这是您调用 Venice API 的账户，而不是另一家托管相同模型的平台。接入监控不要求先充值或调用模型。
先决定能否接受 Admin 权限
账务端点明确要求 Admin，普通模型应用常用的 Inference Only 不适用。Admin 还可管理 Key 和调用付费模型；官方未提供此端点的余额单动作权限。
安全策略不允许时在这里停止，使用下方手动查询。不要改用 Cookie、钱包私钥或业务生产 Key，也没有可粘贴后去掉 Admin 能力的权限 JSON。
创建明确类型的专用 Key
在 API 设置点击 Generate New API Key。Description 可填 Quota Monitor balance，API Key Type 选择 Admin，检查 Expires at 和 Epoch Consumption Limits。
点击 Generate 前再次确认类型。到期时间限制有效期，但消费上限只限制消费，不让 Admin Key 变为只读；不改变已有应用 Key 或权限。
保存一次性显示的秘密值
点击 Generate 后，将完整秘密值复制到密码管理器再关闭结果。后续页面只展示识别信息，不再提供完整秘密值。
完成检查：保存的是秘密值而非名称或遮蔽尾号；录入时不带 Bearer、引号或空白。丢失就更换这把监控 Key，不重拼，不发到聊天、URL 或截图里。
在 Quota Monitor 项目内添加
打开目标项目，添加供应商连接，选择新建连接与 Venice AI（USD）。接入名称应能识别上游账户，把 Admin Key 填入遮蔽凭据框。
保存后等首次同步，或冷却结束后刷新一次。不需要账号 ID、项目过滤、自定义地址或钱包地址；第二个项目可关联同一账号，不会生成第二个钱包。
首次同步逐项对账
将成功查询时间与 USD 金额和同一 Venice 账户对比。balances.usd=25 就是 $25；DIEM=90.5、diemEpochAllocation=100 单独展示为 90.5 / 100，绝不是 $115.5。
套餐与奖励额度各自核对。USD=null 不等于零；缺字段或失败应为同步错误。REST/MCP 中 veniceBalance 使用同样的精确值，不再扣用量。
资金不足时跳到官方页面
卡片 Open provider 打开 Venice API 设置。使用官方入金选项前先检查登录账号与 USD 桶，由有权限的人在 Venice 完成购买。
等官方入账后再刷新。账户有钱时，Key 自身的 USD 或 DIEM 上限仍可能阻止模型调用，不要为了测试监控就提高业务 Key 的限额。
轮换或停用监控
常规轮换时新建专用 Admin Key，经安全表单更新已有连接，同步成功后再在 Venice 撤销旧监控 Key；怀疑泄露时立即撤销。
移除项目关联不等于撤销上游 Key。保留其他项目仍使用的共享连接；不再监控时另行删除或停用连接。排错不要发送原始响应或秘密值。
Quota Monitor 读取的 Venice AI 数据范围
- 阈值只监控 USD 桶。不要把 DIEM、套餐或奖励额度加进美元，也不跨项目重复累加相同账户。diemEpochAllocation 是周期配额，不是额外资金。
- 明确 null 表示官方未提供该余额，不是零。缺字段或请求失败保留上次成功值及其时间；查询时间不能保证结算已完成。
- REST/MCP 保留上游 canConsume 账务信号，不把它当成模型一定可调用。单 Key 上限、权限与其他限制独立，不能只凭 USD 判断停服。
- 仅执行账户账务只读查询，不读取模型内容、不生成、不充值、不管理 Key、不连接钱包。不会用 schema 描述为 Key 范围的 /api_keys/rate_limits 替代账户余额。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
Venice AI 常见问题与排查
- Inference Only 为什么返回 401？
- 账户账务端点要求 Admin，官方错误为 Admin API key required。免费的限流端点接受两种 Key，不证明有账务权限。在本地核对类型，不发送 Key，不尝试 Cookie。
- 还有哪些原因会出现 401 或 403？
- 401 时检查过期、撤销与复制完整性，去掉 Bearer 前缀。403 时请账户所有者核对已配置的 IP 限制与目标接入，不为排错关闭防护或扩权。
- 美元是零，模型为什么还能用？
- DIEM 或其他额度仍可能覆盖适用请求。美元告警只描述 USD 桶；反过来，单 Key 上限也可能在账户有钱时阻止调用。canConsume 不是所有模型的可用保证。
- 余额为空，或与 Key 页面不同？
- null 表示未提供，不猜零。账务 API 查询账号资金，Key 上限另算。请核对同一账号与到账时间，不把 DIEM 加到 USD，也不用限流数据覆盖账务数据。
- 429 或刷新失败怎么办？
- 等待冷却后重试。缺字段或格式不合法会被拒绝，旧成功值保留原时间。仅提供脱敏错误码和时间，不发送 Key 或完整响应。
- 这份教程已用真实账号测试吗？
- 还没有。官方资料与合成测试支持实现，但仍需您亲自检查建 Key、Admin 权限和每项金额。部署成功不代表真实账号验收成功。
Venice AI 官方资料
- 官方账户余额接口（在新标签页打开）
- 官方认证与 Admin 要求（在新标签页打开）
- 官方 Key 创建流程（在新标签页打开）
- 官方 Key 范围接口（不用于本接入）（在新标签页打开）
- 官方 DIEM 说明（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。