端点 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 | 触发条件 |
|---|---|---|
| 401 | new_api_error | 鉴权失败,详见 鉴权 |