多个 LLM API 统一账单
保留每笔费用证据
统一多个 LLM API 费用，同时保留供应商用量、定价、分摊、对账与审计证据。
速览
存储供应商请求 ID、模型、Usage Dimension、Status、Time 与 Source。
建立通用报告字段，同时不抹除供应商原生单位。
要求租户、Team、Project、Product、Environment 与 Cost Center 归属。
匹配供应商导出与账单，再追加有记录的调整。
多个 LLM API 的统一账单本质上是一项核算产品
不同供应商公开的用量字段不同，也可能采用不同的账期截止、币种、区域与商业条款。Input、Cached Input、Output、Reasoning、媒体、存储和 Priority Processing 可能分别计价。因此，统一账单既需要规范类别模型，也不能丢失每一行背后的供应商原生单位与证据。
应分开三层：原始用量、计价成本与客户费用。原始用量记录供应商测量结果；计价成本应用事件发生时生效的费率；客户费用再叠加合同、Credit、税费或内部分摊规则。分层后，价格修正不会篡改底层运营证据。
迟到用量、Credit、退款或争议到来时不要重写历史。应追加关联原记录的 Adjustment Event，并记录原因、来源与审批人，让财务和工程既能复现初始账单，也能复现修正版本。
账单数据层
| 层 | 最适合 | 选择前验证 |
|---|---|---|
| 请求证据 | 解释单次用量与运营结果。 | 核对稳定 ID、尝试、重试、缓存、工具、隐私与重复。 |
| 用量账本 | 跨供应商与租户聚合并分摊。 | 核对不可变性、结构定义版本、单位来源与迟到事件。 |
| 供应商对账 | 对齐内部记录与供应商导出。 | 核对时区、别名、账期、缺失 ID 与舍入。 |
| 统一账单 | 进行一次清晰的 Chargeback。 | 核对币种、税费、Credit、承诺、调整与争议权利。 |
账单治理控制
版本化 Cost Center 映射，并定义缺失 Tag 的处理。
模型价格、路由费、承诺、Credit、税费与币种基准。
记录原因、来源、Approver、影响账期与原始行。
为财务、工程与审计提供符合角色的下钻访问。
可复现地关闭账期
账期关闭应是受控工作流，而不是临时合并表格。需要明确用量何时视为完整、采用哪个价格与汇率快照、谁可以批准调整，以及多大差异必须调查。
- 冻结账期截止、规则版本和汇率来源，再摄取最终供应商导出。
- 去重事件，并按供应商、账户、Project、模型、区域与 Usage Dimension 对账。
- 检查缺失用量、未解释差异、币种基准、税费、Credit 与合同调整。
- 抽样账单行，下钻到原生 Request ID、用量与已应用条款。
- 发布前从不可变输入重新生成同一账单，并比较确定性 Invoice Hash。
保留同一账单的两种视图
统一视图按租户、产品、环境与 Cost Center 汇总标准化类别，让客户或预算负责人能够理解总额。证据视图则保留供应商导出、原生 Request ID、原始单位、价格来源、汇率快照、对账结果及每次调整。每一条统一账单行都应引用其计算所依据的证据集合。
两种视图都应由同一只追加账本和版本化商业规则生成，并在发布文件中保存账本截止点、规则版本与 Invoice Hash。需要修正时，发布关联原账单的新版本或 Credit Note，而不是直接改写旧文件。
生产规则：无法下钻到供应商原生证据与准确适用条款的统一费用，绝不能出账。
纳入工具费用但不把它们变成 Token
QVeris 调用外部 API、工具、服务与实时数据，可能按请求、记录、计算分钟、数据包或订阅计费。每项费用都应在独立能力账本中保留原生单位、Capability ID、供应商证据与价格版本。把所有单位折算成虚构的 Token 等价量，虽然展示更简单，却无法审计。
在统一账单中加入独立的能力费用区段，并通过租户、工作负载与父 Trace 将其关联到推理费用。这样既能显示完整工作流成本，又不会混淆模型费用与外部数据或动作费用，还能看出重试是复用了已有结果，还是产生了新的计费调用。
把统一账单对账到原生用量
统一账单降低采购工作，但不会消除 Usage 账本的必要性。每个请求都应记录供应商、模型、可计费 Token 类型、网关 Fee、Currency 与 Pricing Version，否则月度总额无法解释或分摊。
{
"event_version": 1,
"request_id": "req_01...",
"tenant": "team-support",
"workload": "support-answer",
"provider": "provider-name",
"model": "exact-model-id",
"usage": {"input": 1820, "cached_input": 900, "output": 244},
"price_version": "2026-07-21-usd",
"provider_cost_usd": 0.000000,
"gateway_fee_usd": 0.000000,
"invoice_id": null,
"trace_id": "trace_01..."
}- 将请求账本汇总与供应商导出及聚合商账单对账。
- 把税费、Credits、协议折扣与汇率换算作为独立行。
- 对未映射模型 ID、缺失用量、重复请求 ID 与 Price Version 断层告警。
实施参考已根据官方资料核验：OpenTelemetry GenAI conventions。
FAQ
不是。它是多个独立证据供应商之上的统一财务视图。
不应。报告可标准化类别，但必须保留原生计费单位。
作为有记录的调整事件，关联受影响的供应商行与账期。