请求日志与分析导读
request logs、analytics 和 usage statement 分别适合不同问题。
常见问题不是“拿不到数据”，而是 不知道哪一个面板回答哪一类问题。 这页先帮你分清 request logs、analytics 和 usage statement 的边界。
最小判断法
如果你要解释某次请求为什么这样收费，看 request logs。 如果你要看一周趋势和分组统计，看 analytics。 如果你要做财务月度对账，看 usage statement。
什么时候看什么
Request Logs
适合回答：
某次请求为什么失败？
为什么这次是 BYOK 平台费，不是 shared 模型费？
skills / 外部能力费用是不是这次带出来的？最常用的请求
bash
curl "https://api.therouter.ai/v1/customer/logs?limit=20&start_date=2026-02-01&end_date=2026-02-07" \
-H "Authorization: Bearer $THEROUTER_API_KEY"当你要做单请求排查、客户争议处理或内部费用归集时，这个接口最直接。
最值得先看的字段
text
logs[].traffic_mode
logs[].cost_breakdown.model_charge
logs[].cost_breakdown.byok_platform_fee
logs[].cost_breakdown.managed_tool_fee
logs[].cost_breakdown.total_charge
logs[].billing_note
logs[].skills_used最容易犯的错
- 用 grouped analytics 解释单个 request 的差异。
- 只看总 cost，不看 breakdown。
- BYOK 请求还在误以为 model charge 应该非零。
- 把 request logs 当成财务月度 statement。
账单解释要分层
如果你无法区分一次请求里的 shared、BYOK 平台费和外部能力费用来源，后续就很难解释账单差异。