基于使用的计费让您可以根据客户实际使用的情况进行收费——API 调用、存储、AI 令牌或您定义的任何指标。客户为消费付费，而不是固定费用。
适合：API、AI 服务、基础设施平台以及任何价值随使用而变化的产品。
工作原理
发送使用事件
当可计费操作发生时，您的应用程序会发送事件。{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
计量器汇总使用情况
计量器使用计数、总和、最大值或最后一次聚合将事件汇总为可计费数量。
自动计费
设置每单位的定价和免费阈值。客户在每个周期内自动计费。
核心概念
事件表示您应用中的使用行为。每个事件包括：
- 事件名称：使用类型（例如，
api.call）
- 客户 ID：谁使用了它
- 元数据：用于聚合的附加属性
计量器
计量器将事件汇总为可计费数量：
- 计数：总事件（API 调用）
- 总和：添加值（总字节）
- 最大值：最高值（峰值用户）
- 最后：最近值
具有使用定价的产品
设置每单位的定价和可选的免费阈值：
示例：2,500 次调用 - 1,000 次免费 = 1,500 × 0.02=30.00
客户积分
为客户提供每个计费周期刷新一次的包含使用积分。积分在付费使用之前适用。
快速入门
创建计量器
在您的仪表板中：计量器 → 创建计量器
- 设置事件名称（例如，
api.call）
- 选择聚合方式（计数、总和、最大值、最后值）
- 添加可选过滤器
添加到产品
将计量器链接到具有定价的产品：
- 选择 基于使用的计费
- 选择您的计量器
- 设置每单位的价格和免费阈值
发送事件
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_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" }
}]
})
});
监控使用情况
检查您的计量器仪表板以查看事件和使用汇总。客户在每个周期内自动计费。 API 和基础设施
跟踪 API 调用、计算小时、带宽、存储。示例：10,000 次免费后每次调用 $0.001。
AI 使用跟踪
跟踪令牌、生成、处理时间。示例：每个标准图像 0.04，每个高清图像0.08。 数据与分析
按处理的数据、运行的查询、分析的记录计费。示例：10 GB 免费后每 GB $5。
通信
计算消息、分钟、传输的数据。示例：每发送一条 SMS $0.01。
下一步
