跳转到主要内容
日志查询 API 返回的是控制台「日志」页上的同一批记录:每次调用的模型、令牌、用量和扣费额度。适合每日对账、按令牌统计用量,或把扣费明细导入自己的报表。
旧版系统令牌(AccessToken)已于 2026-11-09 停用。
  • 继续使用旧令牌会返回 HTTP 401,code 为 ACCESS_TOKEN_LEGACY_RETIRED。
  • 创建勾选了 usage:read 的个人访问令牌,替换脚本里的旧令牌;查询参数和返回字段不变。
  • 脚本要检查 success,不能只看返回的数组,否则会把认证失败当成”没有调用”。

查询参数

每页条数不能修改,传 page_size 或 size 不会生效。响应里没有总条数,一直翻页,直到某页少于 10 条为止。

发送请求

先把个人访问令牌设为环境变量:
查询最近一小时 gpt-5.4-mini 的消费记录:
Authorization 直接填个人访问令牌,加 Bearer 前缀也可以。

响应字段

other 里有倍率、缓存命中和工具调用费用。例如使用联网搜索时,web_search_billing 会写明搜索次数和对应额度。只用到总费用时读 quota 即可。响应里还可能有其他字段,解析时忽略不认识的字段。

导出一天的消费并汇总

下面的脚本翻完所有页,按模型汇总扣费。需要 Python 3.9 或更高版本和 requests(python -m pip install requests)。
调用量大的账户一天可能有上千页。可以缩短时间窗口分段拉取,或加上 model_name、token_name 缩小范围。

错误处理

相关文档