导出与对账导读
购买回执、月度 usage statement 和 request logs 分别解决不同问题。
常见问题不是不会导出,而是不知道 应该用哪一种导出解释哪一类问题。 这页先帮你分清 3 个面:购买回执、请求级日志、月度 usage statement。
先记住这一句
purchase receipt 证明你买了多少美元余额; usage statement 解释你这个月怎么花掉的; request logs 用于逐请求排查和内部费用归集。
什么时候看哪一种导出
购买回执
适合回答:
这次买了多少美元余额?
订单和发票金额是多少?
不适合回答:
这周为什么某个 key 花得特别快?月度 usage statement 怎么导
财务和月度复盘优先看月度 usage statement。它比 purchase receipt 更适合说明实际消费。
bash
curl "https://api.therouter.ai/v1/customer/billing/usage-statement.csv?month=2026-03" \
-H "Authorization: Bearer $THEROUTER_API_KEY"请求级导出什么时候用
如果你在做内部费用归集、异常费用排查,或者要解释某次 BYOK / 外部能力费用为什么出现,优先看 request logs 导出。
CSV 导出
curl "https://api.therouter.ai/v1/customer/logs/export.csv?start_date=2026-03-01&end_date=2026-03-07" \
-H "Authorization: Bearer $THEROUTER_API_KEY"最容易误解的地方
- 把 purchase receipt 当成 usage 对账单。
- 只盯着一个总 cost,不看 BYOK 平台费和外部能力费用的分层。
- 试图用月度 statement 解释单个请求失败原因。
- 导出后没有保留短期访问控制和 retention 策略。
数据安全提醒
导出文件本身会带业务敏感信息。不要把它们长期散落在个人机器或无访问控制的对象存储里。