引言
按用量计费已不再仅限于云服务商。API 公司、AI 工具、开发者平台、存储产品以及基础设施类 SaaS 应用正越来越多地根据事件、席位加超额用量、积分、Token、消息数、存储 GB、请求数或计算分钟数收费。对 Node.js SaaS 团队来说,起初听起来还算可控——直到第一位客户质问,为什么发票和用量面板对不上,为什么一条延迟到达的事件改动了账单,或者同一份合同中能否同时包含预充值积分、承诺消费额、阶梯费率以及自定义企业折扣。

本指南将对比 2026 年最实用的 Node.js SaaS 应用按用量计费与计量方案:Stripe Billing Meters、Metronome、Orb、Lago 以及 OpenMeter / Kong Metering & Billing,聚焦于生产架构,而不仅仅是定价页上漂亮的文案。
生产环境下的按用量计费真正需要什么
一个生产级的计量计费系统,远比“统计事件然后扣钱”要复杂得多。你至少需要回答以下问题:
- 什么才是可计费事件? 是一次 API 调用、消耗的 Token、一个存储字节,还是一个席位·日?
- 能否安全重试事件而不重复计费? 幂等性不容商量。
- 哪个客户、工作空间、项目、API 密钥或组织拥有这个事件? 租户边界必须明确。
- 事件是用于计费、额度限制、分析,还是三者兼有? 不同的消费方需要不同的聚合窗口。
- 能否在发票定稿前修正延迟到达的用量? 回填和修正是不可避免的。
- 客户能否在收到账单前查看用量? 用量透明能够减少争议。
- 财务团队能否根据原始用量和合同对账发票? 收入确认需要完整的审计追踪。
- 销售团队能否不经工程修改就创建协商定价? 如果每一笔企业交易都需要改动代码,那就有问题了。
一个早期的 Node.js 小应用可能只需在 PostgreSQL 上记录几个计数器,再搭配 Stripe 订阅即可。这对于简单的“包含 10,000 次请求,超出后每 1,000 次请求 $X”模型是够用的。但一旦加入积分、用量仪表盘、企业合同、多维定价、AI Token 成本或按客户个性化定价,专门的计量或计费层就会显得极具吸引力。
最稳健的架构会将以下四个关注点分离开来:
- 从 Node.js 应用中摄入事件。
- 计量与聚合原始用量,转化为可计费的数量。
- 定价与计价——为正确的客户、正确的指标应用正确的价格。
- 收款、开票、税务与收入运营——财务“管道”部分。
将这几个关注点分开,你的应用就不会在无意中变成一个财务系统。
快速对比表
| 平台 | 最佳场景 | 优势 | 注意事项 | 计费说明 |
|---|---|---|---|---|
| Stripe Billing Meters | 含计量组件的简单 SaaS 订阅 | 原生 Stripe 集成,熟悉的支付栈,直观的订阅管理 | 复杂合同、深入的用量仪表盘及高级计价可能需要额外基础设施 | 按使用量计费,定价按量决定;发布前请确认 |
| Metronome | AI、API 及基础设施公司的大规模用量计费 | 原始事件处理,SQL 风格指标,企业收入工作流,与 Stripe 生态对齐 | 企业采购流程;定价通常不是简单的自助计算器 | 发布前请确认 |
| Orb | 关键任务型按用量计费与收入运营 | 实时事件摄入,自定义 SQL 指标,告警,开票,财务集成 | 自定义定价;可能超出早期阶段需求 | 发布前请确认 |
| Lago | 开源或云端计费,适用于灵活的 SaaS 定价 | 自托管,API 优先,支付渠道无关,混合定价模型 | 自托管的运维负担;需审视 AGPL 许可证影响 | 云版定价请发布前确认 |
| OpenMeter / Kong Metering & Billing | 实时计量、额度管理、用量限制及 Stripe 连接的用量同步 | CloudEvents 风格摄入,仪表定义,用量限制,开源基础 | 产品归属变更为 Kong Metering & Billing | 当前云版详情请发布前确认 |
1. Stripe Billing Meters
对于 Node.js SaaS 团队,Stripe 往往是首先考察的对象,因为可能已经在使用它的支付收款、订阅、Checkout、客户门户、发票、税务和 Webhook 等功能。Stripe 的 Meter Events API 允许你发送用量事件,由 Billing Meters 在一个计费周期内聚合,并附加到价格上。


对于一个简单的 Node.js SaaS 应用,这已经足够:
- 客户订阅一个方案。
- 当客户消耗一个计费单元时,API 发出一个用量事件。
- Stripe 为当前计费周期聚合用量。
- Stripe 生成发票。
这样很有吸引力,因为你不需要维护独立的计费引擎。你还可以复用 Stripe 的 Webhook 来处理订阅生命周期、支付失败、发票定稿及客户门户流程。
示例:从 Node.js 发送 Stripe Meter 事件
import Stripe from "stripe";
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);
async function recordApiCall(customerId: string, count: number) {
await stripe.billing.meterEvents.create({
event_name: "api_calls",
payload: {
stripe_customer_id: customerId,
value: count.toString(),
},
timestamp: Math.floor(Date.now() / 1000),
identifier: `${customerId}-${Date.now()}-${crypto.randomUUID()}`,
});
}
何时适合使用 Stripe Billing Meters
当你的计费模型相对清晰时,适合使用 Stripe Billing Meters:
- 一到几个用量指标。
- 简单的聚合规则。
- 有限的合同定制。
- 优先 Stripe 的支付和发票流程。
- 团队希望减少供应商和变动部件。
示例包括“消息已发送”“活跃项目”“API 调用”“已处理文档”或“存储 GB-月”,这些模型的计价方式对客户来说简单易懂。
Stripe 单独使用时可能变得困难的地方
Stripe 并不总是构建整套用量数据模型的最佳选择。如果你的客户仪表盘需要实时用量,需要回放事件,销售团队需要协商合同,或者财务团队需要详细的用量对账,那么你可能还是需要自己的用量仓库或计量层。
一个务实的 Node.js 做法是:先将事件发送到自己可靠的管道中,然后将计费用量转发到 Stripe。这样 Stripe 仍然作为计费和支付系统,而你自己的基础设施则保留审计追踪。
2. Metronome
Metronome 现在被 Stripe 推介为面向 AI 及现代软件公司的按用量计费平台。它强调原始用量事件存储、基于 SQL 的指标、低延迟流式事件以及大规模支持能力。Stripe 的文档描述了一种分工:Metronome 处理按用量计费、基于积分的定价、企业合同以及多维计价,而 Stripe 则负责支付收款、税务、收入确认、数据导出和欺诈筛查。
这种分离正是许多严肃的 SaaS 团队最终所需要的。
何时适合使用 Metronome
当计费是产品关键系统,而不仅仅是一个小附加项时,Metronome 就非常适合:
- AI 产品 按 Token、积分、任务或模型成本计费。
- API 业务 事件量很大。
- 基础设施 SaaS 具有多维定价。
- 企业合同 包含承诺额、积分、折扣和 marketplace 渠道。
- 团队希望用量计费能与收入运营集成。
对 Node.js 团队来说,关键架构决策在于:你的应用是直接把原始事件推送给 Metronome,还是先通过队列流转,或是使用数仓/流式管道作为记录系统。
成本与采购考量
Metronome 不能像 $20/月的开发者工具那样简单评估。它更接近收入基础设施。如果你的计费复杂度不高,可能显得大材小用。如果计费错误可能导致金钱损失或阻碍企业交易,那么这套专业化系统正是你想要的。请在发布前确认定价与合同细节,因为公开的企业定价可能变化,而且取决于用量、收入、事件体量、支持及实施范围。
3. Orb
Orb 将其定位聚焦于关键任务型按用量计费与收入设计。其功能集包括实时事件摄入、实时告警、混合及按用量计费、自动价格变更、开票、财务与税务集成,以及自定义定价。它还突出展示自定义 SQL 指标、门槛计费、数仓同步、客户层级以及与 Salesforce、NetSuite、会计工具和税务服务商的集成。
何时适合使用 Orb
尤其在以下场景 Orb 非常匹配:
- 你预计定价会频繁变更。
- 你需要同一产品中同时支持销售驱动与自助方案。
- 你向有自定义条款的企业客户销售。
- 你需要对客户用量或费用阈值给出实时告警。
- 财务团队希望拥有清晰的发票、会计和数仓工作流。
- 你需要从原始事件而不仅仅是预聚合计数器来建模用量。
一家开发者工具公司、AI 工作流平台、API 平台或基础设施 SaaS 产品都可以借助 Orb,避免自己构建庞大的内部营收平台。
需要仔细评估的地方
Orb 的公开定价采用自定义定价。这未必是坏事——它可能让费用与计费金额和事件量相匹配。但早期团队在决策前应确认最低平台成本、实施投入、支持级别以及数据可移植性。在评估任何供应商之前,先设计好事件大纲。 计费平台可以摄入事件,但无法魔法般地修正模糊的产品指标。
4. Lago
对于希望获得开源计费基础设施或更多部署控制权的团队,Lago 是一个强有力的选项。其 GitHub 仓库描述其为开放式计费平台,支持按用量、订阅及混合定价模型。它提供 API 优先的方法、与支付渠道无关的集成、自托管能力、用量计量、计费开票、额度管理、支付编排、收入分析,以及 Node.js SDK。
何时适合使用 Lago
在以下情况可考虑 Lago:
- 你需要自托管或严格的数据控制。
- 你希望避免强依赖某个支付处理器。
- 你需要能组合席位、订阅、用量和自定义定价的混合方案。
- 你需要带有开源透明度的 API 优先计费系统。
- 你有足够的工程能力来运维或深度定制系统。
Lago 很匹配那些服务受监管客户、处于支付渠道多样的地区,或需要超出基础订阅工具表达能力的定价模型的 Node.js SaaS 团队。
开源方案的权衡
开源不等于零成本。你可能要在托管、升级、监控、运维支持以及内部专业技能上付出成本。在嵌入或修改平台用于商业环境前,请仔细审阅许可证和商业条款。对于那些看重控制权的团队,这些权衡可能是可以接受的。而对于只需要一个计量价格的小型 SaaS 应用,托管类 Stripe Billing 也许更简单。
// 示例:通过 Lago 的 Node.js SDK 创建计费指标
import { LagoClient } from "lago-javascript-client";
const lago = new LagoClient({ apiKey: process.env.LAGO_API_KEY! });
await lago.billableMetrics.createBillableMetric({
billableMetric: {
name: "api_calls",
code: "api_calls",
aggregation_type: "sum_agg",
field_name: "count",
description: "每个客户每个计费周期的 API 请求数",
},
});
5. OpenMeter / Kong Metering & Billing
OpenMeter 专注于 AI、API 及基础设施用量的实时计量。其价格页现在声明 OpenMeter Cloud 即 Kong Metering & Billing,团队与产品方向保持一致。该平台描述了对 AI 与 API 用量的实时可扩展计量,对 AI 与 API 的访问和成本进行治理,以及用于定价迭代的无代码产品目录。
OpenMeter 的 GitHub 仓库描述了通过 CloudEvents 风格的摄入方式进行用量计量,支持灵活的聚合(SUM、COUNT、AVG、MIN、MAX)、实时用量查询、按用量计费以及用量限制或额度管理。
何时适合使用 OpenMeter
当计量层是系统中最挑战的部分时,OpenMeter 或 Kong Metering & Billing 值得评估:
- API 限制与额度管理。
- AI Token 或成本治理。
- 实时用量仪表盘。
- 用量同步到计费系统。
- 基础设施风格的消耗指标。
- 希望计量在概念上与支付收款解耦。
对于 Node.js API 产品,这可以与网关、API 密钥系统、队列以及 Stripe 或其他支付服务商搭配得很好。
选择前需要验证的方面
由于云产品的归属已变更,请在发布或采购前确认当前定价、功能可用性、Kong 集成细节及支持条款。还需确认你是打算让计量系统单独负责计费、同步到 Stripe,还是仅提供用量限制与分析。
// 示例:发送一个 CloudEvents 风格的计量事件到 OpenMeter
async function recordMeterEvent(
subject: string,
meterSlug: string,
value: number
) {
await fetch("https://api.openmeter.cloud/api/v1/events", {
method: "POST",
headers: {
"Content-Type": "application/cloudevents+json",
Authorization: `Bearer ${process.env.OPENMETER_API_KEY}`,
},
body: JSON.stringify({
specversion: "1.0",
type: meterSlug,
source: "my-nodejs-api",
subject,
id: crypto.randomUUID(),
time: new Date().toISOString(),
data: { value },
}),
});
}
推荐的 Node.js 架构
一个健壮的 Node.js 计量架构不应让随机控制器代码直接发出会影响发票的数据,而缺少可靠路径。一个务实的设置如下:
- Node.js 应用以稳定的事件 ID 记录用量事件。
- 事件被写入一个队列、流或持久发件箱表。
- 一个 worker 校验并丰富事件,补充客户、工作空间、方案、API 密钥和时间戳等数据。
- 原始事件被存储用于审计和回放。
- 计量层将用量聚合成可计费指标。
- 计费系统按照当前定价版本对用量进行计价。
- 发票由计费服务商生成。
- 数仓或财务导出对事件、发票、付款和收入进行对账。
这套架构听起来可能很重,但你可以逐步采用:
- 第 1 天: 发件箱表 + 幂等事件 ID。
- 增长期: 流量增加时添加队列。
- 复杂期: 当定价或客户可见性变得复杂时添加专用计量平台。
TypeScript:用量事件的持久发件箱模式
import { PrismaClient } from "@prisma/client";
import { randomUUID } from "node:crypto";
const prisma = new PrismaClient();
interface UsageEvent {
customerId: string;
workspaceId: string;
eventName: string;
quantity: number;
unit: string;
occurredAt: Date;
metadata: Record<string, string>;
}
async function enqueueUsageEvent(event: UsageEvent): Promise<string> {
const eventId = randomUUID();
await prisma.usageEventOutbox.create({
data: {
id: eventId,
customerId: event.customerId,
workspaceId: event.workspaceId,
eventName: event.eventName,
quantity: event.quantity,
unit: event.unit,
occurredAt: event.occurredAt,
receivedAt: new Date(),
metadata: event.metadata,
schemaVersion: 1,
status: "pending",
},
});
return eventId; // 返回用于幂等性追踪
}
Node.js 团队的事件设计清单
在选定供应商前,先设计事件模型。一个健壮的事件应包含以下字段:
| 字段 | 用途 |
|---|---|
event_id | 全局唯一,用于幂等性 |
customer_id | 计费客户 |
workspace_id / organization_id | 租户边界 |
subject_id | API 密钥、用户、项目、模型、区域或功能 |
event_name | 稳定的指标名(永远不要改变语义) |
quantity | 数值用量 |
unit | 请求、Token、GB、分钟、消息、任务、导出、席位 |
occurred_at | 用量实际发生的时间 |
received_at | 系统收到的时间 |
metadata | 定价维度所需的受控字段 |
schema_version | 以便未来变更不会破坏旧事件 |
永远不要仅依赖发票总额作为事实来源。如果客户对账单提出异议,你需要原始用量路径——每一个事件及其时间戳和来源信息。
成本因素对比
按用量计费平台的收费方式各不相同。有些透明,有些则需要对话。从以下维度比较总成本:
- 月度平台费用
- 计费金额或收入的百分比
- 事件摄入量
- 存储的事件量或保留期
- 发票量
- 客户或订阅数量
- 用量仪表盘功能
- 数仓同步
- Salesforce、NetSuite、税务或会计集成
- 支持等级与 SLA
- 实施或迁移服务
- 自托管运营成本
同时还要考虑出错的成本。如果一个更便宜的平台导致漏计费、客户争议、大量手工财务工作或占用数月工程时间,那它并不便宜。
按场景推荐
只有单一用量指标的早期 SaaS
从 Stripe Billing Meters 和自建原始用量日志开始。 保持架构简单,但不要跳过幂等性及审计存储。这是最好的第一步,因为你无需运营大型营收平台即可落地定价。
定价变化频繁的 API 或 AI 产品
评估专用计量层或完整用量计费平台。 OpenMeter / Kong 可以作为一个优秀的计量优先选项。当定价、开票和收入运营变得复杂时,Orb 或 Metronome 则更加强大。
企业合同驱动你的收入
重点关注 Orb 或 Metronome。 企业计费通常需要承诺额、积分、合同修订、周期内变更、自定义定价、客户层级及财务集成。这些需求后期才强加到基础订阅系统上会非常痛苦。
需要自托管或支付服务商灵活性
评估 Lago。 它在你需要开源可见性、与支付无关的计费或对部署和深度定制拥有更强控制时尤其值得关注。
用量限制像发票一样重要
选择支持额度与限制的计量系统,而不仅仅是开票。对 API SaaS 来说,用量限制是产品体验的一部分。客户需要在收到账单之前就知道是否接近配额。
常见实施错误
错误 1:把计费当成分析
分析可以近似,计费则不行。你需要幂等性、审计追踪、时间戳、修正工作流以及每个事件的明确归属。
错误 2:将定价硬编码在 Node.js 业务逻辑中
硬编码的定价会拖慢销售和产品实验。将定价规则放在可以跟踪版本的计费或定价系统中。
错误 3:只存储聚合计数器
聚合数据很有用,但回填、争议、迁移和调试需要的是原始事件。两者都应该保存。
错误 4:忘记面向客户的用量可见性
如果客户按用量付费,他们就应该能查看到用量。一个好的计费架构应支持接近实时的仪表盘、告警和可导出的用量历史。
错误 5:忽视财务与税务工作流
计费涉及会计、税务、收入确认、销售合同、退款、积分及支持等诸多环节。仅由工程团队做出的决策可能给后期财务带来麻烦。尽早引入财务团队。
结语
最适合 Node.js SaaS 应用的按用量计费平台,更多取决于你的定价复杂度而不是使用的框架:
- 简单定价? 从 Stripe Billing Meters 和持久原始用量日志开始。
- 计量与额度管理是难点? 评估 OpenMeter / Kong Metering & Billing。
- 计费是战略性的营收系统? 对比 Orb 和 Metronome。
- 自托管及支付服务商灵活性很重要? Lago 值得认真审视。
核心原则很简单:不要让 Node.js 应用中的几个计数器变成你的整个计费系统。 保留原始事件,使用幂等性,为定价做版本管理,并在业务模型演进时将支付收款与计量分离开来。