API 参考 › 账户与计费

查询 Token 用量

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

列出当前 API Key 的调用记录,每条给出模型、输入输出 Token 数与实际扣费。

端点 GET /api/log/token

列出当前鉴权 API Key 名下的调用记录明细:调用记录(type 为 2)一条对应一次计费请求;失败的请求另记一条失败记录(type 为 5,不扣费,见下方「失败记录」)。返回的记录里包含 request_id,可与 查询单次请求用量 配合做单笔核对。

请求

鉴权使用 Authorization: Bearer <key>(本接口不接受 x-api-key,只带它会返回 401)。Key 不加 sk- 前缀也可以,加了同样识别。

参数

无。本接口一次返回该 Key 名下的全部记录(上限 1000 条),不支持按时间范围或分页过滤 —— 需要按时间筛选请在客户端处理 created_at。

响应

json
{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 1,
      "created_at": 1790210024,
      "type": 2,
      "model_name": "claude-opus-5",
      "quota": 25,
      "prompt_tokens": 27,
      "completion_tokens": 9,
      "use_time": 2,
      "is_stream": false,
      "token_name": "123",
      "group": "统一调用分组",
      "request_id": "202609240033423335882438268d9d6fQREoTpv",
      "other": "{\"billing_mode\":\"tiered_expr\",\"cache_tokens\":0,\"matched_tier\":\"base\",\"request_path\":\"/v1/chat/completions\"}"
    }
  ]
}
字段说明
data[].created_at请求时间(Unix 秒)
data[].model_name调用的模型 ID
data[].quota本次实际扣费,单位为配额:500,000 配额 = $1
data[].prompt_tokens输入 Token 数,含命中缓存的部分
data[].completion_tokens输出 Token 数
data[].use_time耗时(秒)
data[].is_stream是否为流式请求
data[].request_id本次请求的 ID,与响应头 X-Oneapi-Request-Id 一致
data[].otherJSON 字符串(注意是字符串,不是对象),含计费模式、命中档位、缓存 Token 数、实际请求路径等。需要先 JSON.parse 再用
data[].type记录类型:2 = 调用(扣费)记录,5 = 失败记录(quota 为 0)
data[].content失败记录的摘要,形如 失败 <HTTP> <code> <错误文案> | 耗时 Ns;不含渠道信息
返回的记录不含线路 / 渠道信息与上游模型名:model_name 是你请求的模型 ID,other 里只有计费与请求相关字段。客户端按可选字段处理,未列出的字段请忽略。
other.cache_tokens 是命中缓存读取的 Token 数,且已包含在 prompt_tokens 里。未命中缓存的部分 = prompt_tokens - other.cache_tokens。
上游未返回用量时,本站按 quota: 0 记账并退回预扣,这类记录不是漏计费。

失败记录

请求失败(参数错误、余额不足、上游全部失败、超时等)时也会写一条日志:type 为 5、quota 为 0(不扣费),use_time 为耗时;content 形如 失败 <HTTP> <code> <错误文案> | 耗时 Ns,错误文案最多 80 字、与你收到的错误提示是同一句中文(不再是上游英文原文);content 与 other 不含渠道信息。other 里有 relay_failure: true、status(你实际收到的状态码:流式请求流已开始后失败记 200;网关还没来得及返回、客户端已断开记 499)、error_code、request_path。

示例

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

bash
curl "https://acapi.top/api/log/token" \
  -H "Authorization: Bearer sk-xxxxxx"

错误

HTTP 状态error.type触发条件
401(无 error 对象)鉴权失败。响应体为 {"success": false, "message": "Invalid token"};没带 Key 时 message 为 Token not provided。不带 request id
429(响应体为空)查询过于频繁(每 IP 每 20 分钟 20 次),按 Retry-After 等待,见 速率限制

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