余额查询 API

4ALL API 提供两个 OpenAI 兼容的查询接口,可以用 API 令牌直接查询剩余额度与累计消耗, 便于在业务侧做余额告警或用量看板。

查询额度

curl https://api.4allapi.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $AIPROXY_KEY"

返回示例:

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

hard_limit_usd:该令牌可用的总额度(已用 + 剩余);
access_until:令牌过期时间戳,0 表示长期有效;
若令牌设置了不限额度,该字段会返回一个固定大数。

查询已用量

curl https://api.4allapi.com/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $AIPROXY_KEY"

返回示例:

{
  "object": "list",
  "total_usage": 123.45
}

total_usage 的单位是美分(0.01 美元),123.45 即 $1.2345;
剩余额度 = hard_limit_usd − total_usage / 100。

说明与注意

两个接口不带 /v1 前缀的路径(/dashboard/billing/…)同样可用;
数值口径默认按令牌统计:返回的是当前令牌的额度与用量,不是整个账号;
该接口与 OpenAI 官方的 billing 接口字段兼容,多数支持”余额显示”的第三方客户端 (如 Cherry Studio、Chatbox)可直接用它显示余额;
高频轮询没有意义,建议按分钟级或更低频率查询。