查询已用量

GET

dashboard

billing

usage

curl https://www.qingbo.dev/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $WAVE_API_KEY"

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

返回账号的累计已用量，形状与 OpenAI 的 /dashboard/billing/usage 一致，现成的额度查询工具可以直接对接。

两个容易踩的点：total_usage 的单位是美分（USD × 100），不是美元；本端点忽略 start_date / end_date，钱包制返回的是累计值，不按日期切片。

curl https://www.qingbo.dev/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $WAVE_API_KEY"

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

鉴权

string

必填

Bearer YOUR_API_KEY。

string

固定为 list。

number

累计已用，单位为美分。除以 100 得到美元；上面的 348.2914 即 $3.482914。

OpenAI 的工具习惯用「总额度 − 已用」算剩余：

剩余 USD = subscription.hard_limit_usd - usage.total_usage / 100

查询余额的 total_available_usd 一个字段即为剩余余额，无需两次请求相减。