端点 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。
响应
{
"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[].other | JSON 字符串(注意是字符串,不是对象),含计费模式、命中档位、缓存 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 同样可用,两个地址均可用,见 调用地址。
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 等待,见 速率限制 |