使用日志
查看每次请求的用量、扣费、耗时和错误原因
控制台左侧「API 服务 → 使用日志」打开「请求记录」页面，每一次 API 调用都会记录在这里。
请求记录列表
查看范围
- 时间范围：今天（默认）/ 本周 / 本月，可以用「上一周期」「下一周期」翻页。
- 工作区：个人空间只显示个人密钥的请求；组织密钥的请求要在顶部切换到对应的组织或团队工作区查看。
- 页面每 5 秒自动刷新，正在进行中的请求显示为「请求中」。
列表各列
默认显示：时间、模型、API 密钥、分组调度、Token、性能、消耗、状态。
可以在「显示列」里额外打开：客户端 / 入口、请求类型、会话、IP 地址。
搜索与筛选
搜索框支持 Session、IP 和请求 ID（直接粘贴即可）。
「筛选」里还可以按以下条件过滤：
- 路由：记录分组、路由策略
- 模型、端点
- 身份：API 密钥、Key ID
- 请求属性：请求 ID、状态码（可选「仅错误（≠200）」）、Session ID、IP 地址
- 高级：错误类别、缓存命中、协议转换、成本区间、首字节时间（TTFB）区间
请求详情
点击任意一行打开详情，有三个标签页：
| 标签页 | 内容 |
|---|---|
| 概览 | 总消耗、Token 总数、端到端响应时间；请求 ID、Key ID、Session ID、IP、User-Agent、入口路径、状态码、模型、协议、路由模式（原样透传 / 网关转换）；费用构成（输入 / 输出 / 缓存读取 / 缓存写入）；错误信息 |
| 决策链 | 这次请求在各分组之间的调度过程 |
| 性能 | 延迟分解、首 Token 时间（TTFT）、端到端响应时间、吞吐（TPS）、缓存命中率 |
请求详情抽屉
请求 ID
每次 API 响应都会带上响应头 X-Request-ID，出错时响应体里也有 request_id 字段。它和日志里的「请求 ID」是同一个值。
遇到问题 提交工单 时，附上请求 ID 能让客服直接定位到这次请求。
如果你在请求里自己带了 X-Request-ID 头，它会被记录为「客户端RequestID」，方便和你自己系统的日志对应。
导出
点击「导出」可以下载 CSV（UTF-8 编码，时间为 UTC），最多 50,000 行。包含模型、密钥、输入 / 输出 Token、缓存创建 / 读取、耗时、TTFB、成本（美元）、状态码、错误类别、请求 ID 等字段。