openmeterio/openmeter

这是什么？

核心功能

• 01接收 CloudEvents 事件，按客户和时间窗口实时聚合用量。
• 02支持带版本的套餐、功能，以及固定价、单位价、阶梯价、套餐价和动态价格。
• 03计算功能访问权限和用量额度余额，供应用执行限制。
• 04管理客户积分余额、订阅变更和账单生命周期。
• 05提供 REST API、JavaScript / Python / Go SDK 和 webhook。

适用场景

• 在 AI 或 API 产品中按调用次数、token 或其他计量单位向客户计费。
• 在应用中执行预付费积分或月度用量上限。
• 在同一系统中同时处理按量计费与周期性订阅定价。
• 在保留现有支付服务商的前提下，为已有系统增加用量计量能力。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/openmeterio/openmeter.git
2. 2

   进入 quickstart 目录

   cd openmeter/quickstart
3. 3

   使用 Docker Compose 启动本地评估环境

   docker compose up -d --wait
4. 4

   使用 README 中的 curl、TypeScript 或 Python 示例发送测试事件并查询计量值

使用前须知

• !版本处于测试阶段，可能包含破坏性变更。
• !Python SDK 仍处于预览阶段。
• !Compose 环境仅用于本地评估，Helm Chart 仅用于开发部署，均不适用于生产环境。
• !运行核心组件需要 Kafka、ClickHouse 和 PostgreSQL。

标签

常见问题

openmeter 是什么？

开源的用量计量与按量计费基础设施，可采集用量事件、控制访问权限并生成账单。 OpenMeter 以 CloudEvents 格式采集大规模用量事件，将其归属到具体客户，并实时聚合。它面向 AI、API 以及按量计费的产品，为用量数据提供统一的权威来源。

openmeter 可以免费使用吗？用的什么许可证？

openmeter 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

openmeter 还在维护吗？

活跃维护中。openmeter 最近一次提交是在 2026年11月7日。

openmeter 适合用来做什么？

在 AI 或 API 产品中按调用次数、token 或其他计量单位向客户计费。 在应用中执行预付费积分或月度用量上限。 在同一系统中同时处理按量计费与周期性订阅定价。 在保留现有支付服务商的前提下，为已有系统增加用量计量能力。

openmeter 怎么安装和运行？

克隆仓库: git clone https://github.com/openmeterio/openmeter.git 进入 quickstart 目录: cd openmeter/quickstart 使用 Docker Compose 启动本地评估环境: docker compose up -d --wait 使用 README 中的 curl、TypeScript 或 Python 示例发送测试事件并查询计量值

在哪里获取 openmeter？

源代码和安装说明在 GitHub 上：https://github.com/openmeterio/openmeter