API 参考 › 账户与计费

查询账单汇总

文档最后更新于 2026年10月16日 02:29

返回当前 API Key 自开通以来的累计消费金额,只给一个合计值。

端点 GET /v1/dashboard/billing/usage

返回当前鉴权 API Key 的累计消费,只给一个合计数字,不返回逐请求明细,也不接受时间范围参数。

请求

鉴权使用 Authorization: Bearer <key>(本接口不接受 x-api-key,只带它会返回 401)。

参数

可选 start_date / end_date(YYYY-MM-DD),但当前实现不对结果做过滤,返回值恒为累计总额。要按时间对账请用 查询 Token 用量 返回的逐条记录。

响应

json
{
  "object": "list",
  "total_usage": 15317.105599999999
}
字段说明
total_usage累计消费,单位是美分(0.01 美元),不是美元。要换算成美元请除以 100
total_usage 的单位容易看错:例中的 15317.1056 是 $153.17,不是 $15317。
价格可能调整,历史账单以接口返回的金额为准,不能用当前价格表反推。

示例

本页接口与模型无关,示例用 https://acapi.top;换成国内通道 https://api.acapi.top 同样可用,两个地址均可用,见 调用地址。

bash
curl "https://acapi.top/v1/dashboard/billing/usage" \
  -H "Authorization: Bearer sk-xxxxxx"

错误

HTTP 状态error.type触发条件
401new_api_error鉴权失败,详见 鉴权

共 30 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。