NanoGPT 美元余额查询与 API Key 接入教程

不托管 Key 也能手动查看余额

1. 打开 nano-gpt.com/balance，登录实际使用的账户。
2. 分别查看 USD、Nano、订阅及团队钱包，不合并口径，记录账户与时间。
3. 对比本站时刷新一次，比较同一美元字段和时间；人工查询不需要向本站发送密钥。

在 Quota Monitor 中接入 NanoGPT

1. 01

   确认账户与美元钱包

   打开官方 Balance 余额页，登录应用实际使用的 NanoGPT 账户，先记下美元金额与账户信息。

   核对美元字段，不是 Nano 币数额、订阅额度或团队钱包。接入监控不需要充值或调用收费模型。

   打开 NanoGPT 官方页面（在新标签页打开）
2. 02

   确认愿意托管这类权限

   打开官方 API integration 页面，在 API keys 区域准备创建 Quota Monitor 专用 Key，不复用线上业务 Key。

   普通 API Key 可以调用收费服务。余额文档未给出余额专用权限；若必须保证凭据只读，请在这里停止并人工查账，不能用管理令牌替代。

   打开 NanoGPT 官方页面（在新标签页打开）
3. 03

   创建独立 API Key

   在 API integration 页找到 API keys，点击 Create API key。如果界面提供名称字段，可填写 Quota Monitor balance，再完成创建。

   检查实际界面可用的 Key 控制项。设置消费限额可降低风险，但不等于只读；不要修改或撤销现有业务 Key，也无需扩大团队或管理员权限。

   打开 NanoGPT 官方页面（在新标签页打开）
4. 04

   安全复制完整密钥

   将新 Key 完整保存到可信密码管理器。新格式为 sk-nano- 加 UUID，旧版纯 UUID 格式的 API Key 也支持。

   只粘贴密钥本身，不带 Bearer、x-api-key:、引号或空格。不要提交 sk-nano-mgmt- 管理令牌、登录恢复密钥或 Cookie，也不要发到聊天、截图、URL 或 MCP 参数。

   打开 NanoGPT 官方页面（在新标签页打开）
5. 05

   在目标项目内添加连接

   回到 Quota Monitor，打开目标项目并添加供应商连接，选择 NanoGPT（美元），填写可识别的连接名称，将 Key 粘贴到遮蔽输入框。

   保存并接入当前项目。不需填写自定义网址、币种、上游项目 ID、团队 ID 或 Key ID，账户由 Key 决定。

6. 06

   完成首次只读同步

   等待首次同步或点击查询最新余额。本站只向固定地址发送带 x-api-key 的无请求体 POST，不发起收费模型请求。

   成功后卡片显示账户美元余额并更新同步时间。失败请按下方步骤排错，不要通过扩大权限或提供登录会话绕过。

7. 07

   核对相同账户与金额

   打开同一账户的官方 Balance 页，在接近的时间比较美元余额。usd_balance=25 即 $25，Nano 币单位不是待换算的美元字段。

   不一致时先核对账户、近期消费、查询时间及钱包类型。REST/MCP 的 nanogptBalance.balance 应与卡片同一快照一致；同账户的其他项目共享资金，不是新钱包。

   打开 NanoGPT 官方页面（在新标签页打开）
8. 08

   维护密钥并完成真实验收

   资金不足时点击卡片前往平台，进入官方 Balance 页；本站不代充值。轮换时先创建新专用 Key 并安全更新连接，再停用旧监控 Key，不影响业务 Key。

   真实账号验收仍待用户完成：请逐项核对创建过程、权限、账户选择、美元金额及教程。遇到问题仅反馈脱敏错误码与时间。

   打开 NanoGPT 官方页面（在新标签页打开）

Quota Monitor 读取的 NanoGPT 数据范围

• 仅监控 usd_balance。单独的 nano_balance 是 Nano 加密货币，不是美元，不折算、不相加。美元为零不代表整个账户没有可用资源。
• 不包含订阅额度、单 Key 消费限额、上游平台余额或团队汇总。该接口未提供团队选择器；请核对 API Key 所属账户，不要以默认团队或网页登录时选中的钱包替代。
• 多个 Key 和本站项目可能共享同一账户资金，不能重复汇总或再次减去已花费用。REST/MCP 的 nanogptBalance.balance 使用同一次成功快照。
• 本站只发起此余额只读请求，不调用模型、不创建密钥、不使用登录会话、不充值或改权限。正美元余额不能保证某个模型一定可调用。
• 保留零和负数。缺字段、无效数值及查询失败保留旧金额与旧时间，不伪造零；快照时间不是供应商实时结算承诺。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

NanoGPT 常见问题与排查

Key 被拒绝或 HTTP 401？

检查是否从 API keys 复制完整的 sk-nano-UUID 或旧版 UUID Key，去掉请求头前缀和空白。sk-nano-mgmt- 管理令牌与登录恢复密钥不是 API Key，确认专用 Key 未撤销，不发送 Key 给客服。

HTTP 403 或不接受凭据权限？

确认 Key 属于正确账户，检查 API keys 页面实际可用的限制项。官方没有余额专用权限说明，不要增加管理员或团队权限，也不要取消所有限额来排错。请联系 NanoGPT 支持确认限制或人工查看 Balance。

美元为零，但还有 Nano 或订阅？

本连接只读 usd_balance。nano_balance 是另一种货币，订阅用量是另一种指标，不折算也不相加。美元为零不能判断某一模型还能否调用。

与 Key 限额、团队钱包或其他项目不一致？

先对齐 API Key 所属账户、美元字段与查询时间。该接口没有已文档化的团队选择器，网页登录选中团队不代表该 Key 的账户范围。Key 限额不是资金，重复账户快照不要相加。

HTTP 400、404、429、跳转或响应异常？

保留脱敏错误码和时间。429 时等待自动重试或手动刷新冷却结束。usd_balance 缺失、格式错误或网络失败会保留旧成功快照，旧时间不代表新零余额；不改用 Cookie 或其他主机重试。

能用只读的管理令牌吗？

不能。Management API 使用不同鉴权来查询订阅用量，未文档化用该令牌查询本美元余额。不要把订阅剩余当钱，也不要扩大管理令牌权限。当前接入仍需真实账号验收。

NanoGPT 官方资料

• NanoGPT 官方文档 · /api-reference/endpoint/check-balance（在新标签页打开）
• NanoGPT 官方文档 · /authentication（在新标签页打开）
• NanoGPT 官方文档 · /api（在新标签页打开）
• NanoGPT 官方文档 · /api-reference/miscellaneous/api-hosts（在新标签页打开）
• NanoGPT 官方文档 · /api-reference/management-api（在新标签页打开）
• NanoGPT 官方文档 · /api-reference/teams（在新标签页打开）

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