2026-07-05 · 5 分钟阅读
无需数仓的客户账单查询
如果你转售 LLM Token 或运营 Agent 平台，客户迟早会问：「这个月花了多少？」或「那次 Agent 运行成本多少？」
常见做法是把事件导入数仓、搭建看板，再祈祷数字和拦截层一致。FluxMeter v2.6.1+ 提供了更轻的路径：基于与预算拦截相同的 Redis 汇总，直接提供查询 API。
v2.6.1–2.6.2 能力
四种查询模式覆盖大多数面向客户的账单 UI 需求：
GET /usage/customer/{id}/period/{YYYY-MM} — 按 UTC 日历月汇总。GET /usage/customer/{id}/day/{YYYY-MM-DD} — 日用量，适合「今日消耗」组件。
GET /usage/session/{id} — 在 lite 摄入时设置 sessionId，聚合一次会话或项目的成本。GET /usage/span/{id} — 子 LLM 调用共享 parentSpanId 时，查询单次 Agent 任务总成本。
自 v2.6.2 起，Lite /ingest 会对 parentSpanId 递增计数 — 无需 Flink 即可使用相同的 GET /usage/span/{id}。
何时使用哪个字段
月度和日度查询无需额外摄入字段 — Lite 与 Full 模式下，汇总桶从部署日起累积。
会话查询适用于 lite 摄入 + sessionId（默认 90 天 TTL）。Kafka/Flink 路径请在每次子调用上设置 parentSpanId，再查询 GET /usage/span/{id}。
日/月桶不支持历史回填 — 需设定切换日期，或接受部署前的用量无法通过这些接口查询。
如何融入你的技术栈
FluxMeter 仍是拦截层，不是发票系统。这些 API 适用于客户看板、预付费钱包 UI 和 Agent 成本明细。
正式账单仍导出到 Stripe、Lago 或 Orb。查询 API 回答的是「现在给用户看什么？」—— 无需等待夜间 ETL。
本地试用
运行 make demo，摄入几条带 sessionId 或 parentSpanId 的事件，再 curl 月/日/会话/span 接口。完整 API 参考见主仓库文档。