API 中转介绍
使用记录
按 API 密钥 / 时间 / 模型筛选查询调用明细,导出 CSV 做对账。
界面概览

页面分 3 块:
| 区域 | 内容 |
|---|---|
| 顶部 4 大汇总卡片 | 总请求数 / 总 Token / 总消费 / 平均耗时 |
| 筛选条件 | API 密钥下拉 + 时间范围 + 刷新 / 重置 / 导出 CSV |
| 明细表格 | 12 列:API 密钥 / 模型 / 推理强度 / 端点 / 类型 / 计费模式 / TOKEN / 费用 / 首 TOKEN / 耗时 / 时间 / USER-AGENT |
顶部汇总卡片
| 卡片 | 含义 |
|---|---|
| 总请求数 | 当前筛选范围内所有调用次数(含成功 + 失败) |
| 总 Token | 输入 + 输出 Token 合计 |
| 总消费 | 实际扣费金额(USD)— 已计算分组倍率 |
| 平均耗时 | 平均一次请求耗时(毫秒) |
「实际 / 标准」对照:总消费区显示「实际 / 标准」两个数。实际 = 你按倍率付的钱;标准 = 按 0 倍率(无溢价)的参考价。两者差值反映了你选的分组的额外稳定性溢价。
筛选条件
API 密钥
下拉选择查看单个 Key 的明细,默认是「全部密钥」。
用法:
- 排查某个 Key 的异常用量
- 给团队成员做对账(每人一个 Key)
- 区分生产 / 测试用量
时间范围
预设选项:
- 今日
- 近 7 天(默认)
- 近 30 天
- 自定义(自选起止日期)
操作按钮
| 按钮 | 用途 |
|---|---|
| 刷新 | 拉最新数据 |
| 重置 | 清空所有筛选条件回到默认 |
| 导出 CSV | 把当前筛选结果导出为 CSV 文件,本地用 Excel / Numbers 开 |
明细表格 12 列详解
| 列 | 含义 |
|---|---|
| API 密钥 | 调用此次的 Key 名(如 cursor-mac、ci-prod) |
| 模型 | 实际请求的模型 ID(如 gpt-5.4、claude-sonnet-4-6) |
| 推理强度 | low / medium / high / xhigh |
| 端点 | /v1/responses / /v1/messages / /v1/chat/completions 等 |
| 类型 | chat / image / embedding 等 |
| 计费模式 | pay-per-use 等 |
| TOKEN | 输入 + 输出 Token,格式 IN: 1234 / OUT: 567 |
| 费用 | 这一次调用消耗的 USD(含倍率) |
| 首 TOKEN | 流式响应的首字延迟(ms) |
| 耗时 | 完整请求耗时(ms) |
| 时间 | 调用时间戳,按降序排列 |
| USER-AGENT | 调用方标识(如 Codex/0.42 (macOS 14.5)) |
排序与列宽
- 列名右侧的
v图标 表示该列可排序,点一下切换升序 / 降序 - 推荐排序:按 时间 倒序看最近的 / 按 费用 倒序看最贵的 / 按 耗时 倒序找慢请求
典型排查场景
① 余额突然消耗很快
- 筛 「今日」 + 「全部密钥」
- 按 「费用」 倒序,前 10 条是大头
- 看是哪个 API 密钥 + 模型 在烧钱
- 是不是某个客户端配置错了模型(如把
gpt-5.4-mini误改成gpt-5.5)
② 某个 Key 调用全部失败
- 筛选该 Key → 看是否还有最近成功记录
- 没有任何记录 → Key 已被禁用 / 删除 / 客户端配置错了
- 有失败记录 → 看「类型」/「端点」找具体错因
③ 请求耗时变长
- 按 「耗时」 倒序
- 集中在某个模型 → 该模型本身慢(如
gpt-5.5 + xhigh推理) - 集中在某段时间 → 网络问题 / 上游故障
④ 月底对账
- 筛 「近 30 天」
- 按 「API 密钥」 聚合(导出 CSV 后用 Excel 透视表)
- 按团队 / 项目维度汇总
导出 CSV
点右上角 「导出 CSV」 按钮:
- 文件名:
usage-<开始日期>-<结束日期>.csv - 编码:UTF-8 with BOM(Excel / Numbers 直接打开不会乱码)
- 包含表格所有 12 列
- 可用 Excel 透视表做按 Key / 模型 / 日期的多维度汇总
空状态
刚注册 / 当前筛选范围内无调用时显示「暂无数据」。
看完使用记录怎么办
| 发现的问题 | 行动 |
|---|---|
| 余额接近耗尽 | 仪表盘 → 「充值」 |
| 某 Key 异常消耗 | API 密钥 → 编辑 Key 加日额度上限 |
| 某模型偏贵 | 改用更便宜的模型 / 更低推理强度 |
| 多个客户端在用 | API 密钥 按用途拆开多个 Key |
