导出与对账导读

购买回执、月度 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 策略。
数据安全提醒
导出文件本身会带业务敏感信息。不要把它们长期散落在个人机器或无访问控制的对象存储里。

下一步

帮助与联系