接口文档
查询单把 API Key 的请求日志
查询一把 BetterToken API Key 最近的请求记录,最多返回 1,000 条。了解时间戳、请求 ID、Token 用量和消费金额字段,以及分页和筛选限制。
使用 GET https://bettertoken.ai/api/log/token 查看一把 BetterToken API Key 最近的请求记录。
发送请求
使用平时调用模型的 sk-... BetterToken API Key。先将它设为本地环境变量 BETTERTOKEN_API_KEY,再运行以下命令。
请求使用 Authorization: Bearer <API_KEY>,没有参数或请求体。完整 URL 不带 /v1。
curl -sS 'https://bettertoken.ai/api/log/token' \ -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"成功响应
成功时 success 为 true,data 是这把 Key 的日志数组。最近写入的记录排在前面,最多返回 1,000 条。
接口没有分页、时间筛选或请求 ID 筛选。
示例只展示常用字段,数值仅供演示。
{ "success": true, "message": "", "data": [ { "created_at": 1795046400, "type": 2, "model_name": "gpt-6.2-sol", "request_id": "example-request-id", "prompt_tokens": 120, "completion_tokens": 48, "quota": 600, "recorded_amount": "0.0012", "currency": "USD" } ]}读取日志字段
| 字段 | 含义 |
|---|---|
created_at | Unix 时间戳,单位为秒。 |
model_name | 模型 ID。 |
request_id | 若记录包含此字段,可用它与模型请求对应。 |
prompt_tokens | 记录的输入 Token 数量,视接口及计费方式而定。 |
completion_tokens | 记录的输出 Token 数量,视接口及计费方式而定。 |
type | 2 表示消费记录。 |
quota | 记录的额度值,使用内部额度单位。 |
recorded_amount | 以十进制字符串表示的金额。带有已保存计费换算系数的消费记录会返回此字段。 |
currency | 金额对应的币种,如 USD。 |
处理金额
recorded_amount 缺失时,不要记作零金额。按 currency 区分币种,同币种分别汇总。
相关查询
需要看这把 Key 的累计用量和剩余额度时,参见查询 API Key 额度。如需查看账户级历史,请打开 BetterToken Workspace。

