跳转到主要内容
想在脚本、程序或者别的工具里看看还剩多少钱?用你的 API Key 调一个接口就行。不用登录控制台,查询本身也不扣费。 只需要两样东西:

查询余额

把下面命令里的 sk-你的KEY 换成你自己的 Key,然后运行:
地址最后的 / 不要漏掉,完整写成 https://ruoli.dev/api/usage/token/。

看懂返回结果

返回示例(数字是举例):
所有额度数字除以 500000 就是人民币:

无限额度令牌怎么看余额

令牌是「无限额度」时,按令牌查出来的剩余是负数。无限额度的令牌没有自己的上限,每次调用直接扣账户余额,所以 total_available 只是「0 减去已用」,看不出真实余额。
想看账户的真实余额,给这个令牌开一下权限:
1

打开令牌设置

登录 ruoli.dev,进入「令牌」页面,编辑要查询的令牌。
2

开启「允许查询用户额度」

打开 允许查询用户额度,保存。
3

重新查询

再运行一次上面的命令,看返回里的 data.user_quota.total_available,除以 500000 就是账户余额。
这个开关只影响查询接口能不能看到账户余额,不会改变令牌的额度和调用权限。

在第三方客户端里显示余额

很多聊天客户端和余额查询小工具,用的是 OpenAI 的老式账单接口。在客户端里把 API 地址填成 https://ruoli.dev、Key 填你的令牌,一般就能直接显示余额。 它们调用的是下面两个接口,你也可以自己查:
这两个接口只按令牌统计。令牌是无限额度时,请改用上面的 /api/usage/token/ 并开启「允许查询用户额度」。

常见报错

Key 复制错了、已被删除、已禁用或已过期。回到控制台「令牌」页确认状态,重新复制完整的 sk- 开头字符串。
查询也要从白名单里的 IP 发出,否则会被拒绝。
检查地址:用 https,路径结尾带 /,完整写成 https://ruoli.dev/api/usage/token/。
可以,但查询接口有频率限制,几分钟查一次就够了。