基于使用的计费让您可以根据客户实际使用的情况进行收费——API 调用、存储、AI 令牌或您定义的任何指标。客户为消费付费，而不是固定费用。
适用于：API、AI 服务、基础设施平台以及任何价值随使用规模扩大而提升的产品。
工作原理
Send Usage Events
当发生可计费操作时，您的应用会发送事件。{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
Meters Aggregate Usage
计量器使用计数、求和、最大值或最近一次聚合将事件汇总为可计费数量。
Automatic Billing
设置每单位定价和免费额度。客户将自动每个计费周期计费。
核心概念
事件代表您应用中的使用行为。每个事件包括：
- 事件名称：使用类型（例如
api.call）
- 客户 ID：谁使用了它
- 元数据：用于聚合的附加属性
计量器
计量器将事件汇总为可计费数量：
- 计数：总事件（API 调用）
- 总和：添加值（总字节）
- 最大值：最高值（峰值用户）
- 最后：最近值
具有使用定价的产品
设置每单位的定价和可选的免费阈值：
示例：2,500 次调用 - 1,000 次免费 = 1,500 × 0.02=30.00
基于信用的扣减
您可以配置计量器从客户的信用余额中扣除，而不是按单位收费。信用会在每个账单周期刷新，并在任何超额费用之前应用。
快速入门
Create a Meter
在控制面板中：Meters → Create Meter
- 设置事件名称（例如
api.call）
- 选择聚合方式（Count、Sum、Max、Last）
- 添加可选筛选条件
Add to Product
将计量器与具有定价的产品关联：
- 选择 Usage-Based Billing
- 选择您的计量器
- 设置每单位价格和免费额度
Send Events
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "unique_event_id",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/users" }
}]
})
});
Monitor Usage
查看您的计量器仪表盘以了解事件和使用量聚合情况。客户将自动在每个周期计费。 APIs & Infrastructure
跟踪 API 调用、计算小时数、带宽、存储。示例：前 10,000 次免费，之后每次 $0.001。
AI Usage Tracking
跟踪令牌、生成次数、处理时间。示例：每张标准图像 0.04，高画质0.08。 Data & Analytics
按处理数据量、执行查询、分析记录收费。示例：前 10 GB 免费，之后每 GB $5。
Communication
统计消息、分钟数、传输数据。示例：每条短信 $0.01。
下一步
