文档目录

查询余额接口

用 API 密钥查询账户余额，客户端和脚本都能用。

本站提供 OpenAI 兼容的余额查询接口。支持“查询余额”的客户端（如 NextChat 等）填好接口地址和 API 密钥后就能直接显示余额；你也可以在自己的脚本里调用它，做余额监控或提醒。

接口

GET /v1/dashboard/billing/subscription：账户总额度（当前余额 + 已用金额）。
GET /v1/dashboard/billing/usage：已用金额，单位是“分”（金额 × 100）。

两个接口都用 API 密钥鉴权，请求头写法和调用模型一样。地址不带 /v1 也可以（/dashboard/billing/subscription、/dashboard/billing/usage），方便接口地址只填了域名的客户端。

示例

GET /v1/dashboard/billing/subscription

curl https://tokenwayapi.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-xxxxxxxx"

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

GET /v1/dashboard/billing/usage

curl https://tokenwayapi.com/v1/dashboard/billing/usage \
  -H "Authorization: Bearer sk-xxxxxxxx"

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

怎么算出余额

余额 = hard_limit_usd − total_usage ÷ 100。按上面的例子：100 − 885.29 ÷ 100 = 91.15，和控制台显示的余额一致。客户端的“查询余额”功能就是这样算的，不需要你手动换算。

单位和范围

返回的是整个账户的余额（同一账户下的所有密钥共用），单位和控制台一致，是人民币元。字段名里的 usd 是沿用 OpenAI 接口的写法，部分客户端也会在数字前加 $ 符号，实际单位仍是人民币。

密钥无效会返回 401，其他报错请对照错误码。

选好模型，核对费用再接入

查看当前模型的价格与参数，用自己的输入、输出和缓存用量估算成本；遇到报错时按错误码排查。

模型目录与接入 API 费用计算器错误码与排查

请求详情与用量记录

错误码