Usage Logs Walkthrough
TT API 的「调用日志」页记录每次请求的模型、输入/输出 token、耗时、首字延迟（TTFT）、状态码和扣费，支持按时间、模型、Key、状态码、用户筛选。本文讲怎么用它排查问题、复盘消耗、对账。
在哪里看
控制台左侧导航 → 「调用日志 / Usage Logs」。默认按时间倒序展示最近 7 天。
一行日志包含什么
| 字段 | 含义 |
|---|---|
| 时间 | 请求到达服务器的精确时间（带时区） |
| 模型 | 实际命中的模型名（如 claude-4.7-opus） |
| Key 名称 | 哪一把 API Key 发出的请求 |
| 输入 Token | Prompt + 上下文消耗的 Token 数 |
| 输出 Token | 模型生成的 Token 数 |
| 缓存命中 Token | 如果命中 Prompt Cache，这部分是折扣价 |
| 耗时 | 从请求到响应完成的总毫秒数 |
| 状态码 | 200 成功；4xx 客户端错误；5xx 服务端错误 |
| 消耗 | 折算成美元等值的扣费金额 |
| 来源 IP | 调用方公网 IP（脱敏后 4 字段保留 2 字段） |
点击任意一行可以展开，看到完整的请求/响应预览、错误堆栈、Token 拆解。
筛选
顶部支持组合筛选：
- 时间范围：快捷按钮（今天 / 24h / 7d / 30d）+ 自定义日期区间
- 模型：多选，看某几个模型的消耗
- API Key：按 Key 看流量分布
- 状态码：单看失败请求时勾「非 2xx」
- 耗时区间：找慢请求时勾「> 5s」
筛选条件会拼到 URL，方便分享给同事看同一份视图。
排查失败请求
按状态码筛 4xx / 5xx 后点开任一行，常见错误码含义：
400 Bad Request— 请求体 JSON 不合法 / 模型不存在 / messages 为空401 Unauthorized— API Key 错误、被禁用、过期、或不在 IP 白名单402 Payment Required— 余额不足 / 单 Key 额度超限429 Too Many Requests— RPM 限速触发，等几秒重试5xx— 服务临时不可用，可重试
展开行里的「错误详情」会带上原始供应商返回，便于定位是网关问题还是模型本身的拒答。
导出
右上角「导出 CSV」按当前筛选条件下载日志，最多导出 100,000 行。常见用途：
- 月度账单和发票核对
- 给财务做内部分账（按 Key 名 → 项目 → 部门）
- 流量异常的离线分析
数据保留
调用日志默认保留 90 天，超过保留期的数据每日 0 点清理。如果你需要更长保留期，可以定期导出存档，或在「系统设置」中调整保留窗口（管理员权限）。
常见问题
Q：日志显示输入 1000 token，但我的 prompt 只有几十字，为什么这么多？ A：上下文里附带的历史消息、system prompt、tool definitions 也会计入 input。复盘消耗时关注「上下文累积」。
Q：缓存命中怎么看是不是真的命中了？ A：展开行里的「缓存命中 Token」如果 > 0，说明这部分按缓存价（通常是原价 10% 左右）计费。
Q：失败请求扣费吗？
A：4xx 通常不扣（请求没到模型），5xx 视情况；保险起见把失败请求的费用核对到「消耗」字段为准。