查询额度(new-api 兼容)

OpenAI 早已下线的旧版计费接口,被 one-api 采纳、new-api 继承,如今几乎所有 「查余额」工具都在探测这个路径。实现它,是为了让 JuCode 的 Key 在那些工具里 直接可用,不需要专门的插件。 同一个处理逻辑挂在两个路径上:`/dashboard/billing/subscription` 和 `/v1/dashboard/billing/subscription`。上游两个都提供,客户端也分成了两拨。 ### 字段名写着 usd,单位却是元 JuCode 的记账单位是积分(1 积分 = 1 元)。这个格式里没有货币字段可以说明这件事, 而按某个汇率折成美元只会让数字和控制台对不上。所以三个 `*_usd` 字段里装的是 **元**,在前面印 `$` 的客户端印错了符号,数字本身是对的。new-api 的运营者把 `quota_display_type` 设成 CNY 时行为完全一样。 需要明确单位的场景请用 [`GET /v1/open/balance`](/docs/api/account/getBalance)。 ### 这个数字是「累计授予」,不是「剩余」 三个 `*_usd` 字段都等于**余额 + 历史总消费**。因为所有查余额工具都做同一个减法: ``` 剩余 = soft_limit_usd - total_usage / 100 ``` 配合 `/dashboard/billing/usage` 返回的已消费额,这个减法正好落在真实余额上。 ### Key 带总额上限时口径会变 如果调用所用的 Key 设置了 `total_cost_limit`,返回的是**该 Key 的**上限与消费, 而不是账户的。带上限的 Key 是一份子预算,持有者关心的是那个天花板;报账户余额 会让一个受限的 Key 声称自己拥有全部余额。 查询参数一律忽略。

剩余 = soft_limit_usd - total_usage / 100

curl -X GET "https://example.com/dashboard/billing/subscription"

{  "object": "billing_subscription",  "has_payment_method": true,  "soft_limit_usd": 200,  "hard_limit_usd": 200,  "system_hard_limit_usd": 200,  "access_until": 0}