按使用量计费

通过灵活的计量和自动化计费，根据客户实际使用量收费。

按使用量计费会根据客户的实际用量收费，例如 API 调用、存储、AI tokens 或任何由你定义的指标。客户为实际使用的内容付费。你可以添加固定基础费用，也可以将其设为零。

最适合：API、AI 服务、基础设施平台，以及任何价值会随用量增长的产品。

​

原理

1. Send Usage Events

   您的应用在发生可计费操作时发送事件。

   {
     "events": [
       {
         "event_id": "evt_123",
         "customer_id": "cus_abc",
         "event_name": "api.call",
         "metadata": { "endpoint": "/v1/users" }
       }
     ]
   }
   
2. Meters Aggregate Usage

   计量器使用计数、总和、最大值或最后一个聚合事件以转换为可计费的数量。

3. Automatic Billing

   设置每单位价格和可选的免费额度。客户会在每个周期自动完成计费。

​

核心概念

​

事件

事件表示应用中的用量操作。每个事件包括：

• 事件名称：用量类型（例如 api.call）
• Customer ID：使用者
• Metadata：用于聚合和筛选的其他属性

​

计量器

Meters 会将事件聚合为可计费数量：

• Count：事件总数（API 调用、上传）
• Sum：数值总和（总字节数、tokens）
• Max：周期内的最高值（峰值用户数、最大存储量）
• Last：最近的值

​

基于使用量定价的产品

设置每单位价格和可选的免费阈值：

示例：2,500 次调用减去 1,000 次免费额度 = 1,500 次可计费调用 × $0.02 = $30.00

​

基于积分的扣除

可以配置计量器从客户的积分余额中扣除，而不是按单位按美元收费。积分在每个计费周期刷新，并在任何超额费用之前应用。

​

快速入门

1. Create a Meter

   前往控制面板中的 Meters，然后点击 Create Meter。

   1. 输入事件名称（例如 api.call）
   2. 选择聚合类型（Count、Sum、Max 或 Last）
   3. 添加可选筛选条件，以排除特定事件
2. Add Meter to a Product

   将 Meter 关联到产品并设置定价：

   

   1. 前往 Products，然后选择或创建产品
   2. 将 Usage Based Billing 选择为定价类型
   3. 选择你的 Meter
   4. 设置每单位价格和可选的免费额度
3. 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" }
       }]
     })
   });
   
4. Monitor Usage

   

   查看 Meter 的控制面板，了解事件和聚合后的用量。客户会在每个计费周期自动完成计费。

​

使用案例

APIs and Infrastructure

跟踪 API 调用、计算时长、带宽或存储量。示例：免费提供 10,000 次调用，之后每次调用收费 $0.001。

AI Usage Tracking

跟踪 tokens、图像生成次数或处理时间。示例：每张标准图像收费 $0.04，每张高清图像收费 $0.08。

Data and Analytics

根据处理的数据量、运行的查询或分析的记录数计费。示例：免费提供 10 GB，之后每 GB 收费 $5。

Communication

按消息数、分钟数或传输的数据量计费。示例：每条发送的 SMS 收费 $0.01。

​

下一步

Event Ingestion

学习如何从您的应用结构和发送使用事件。

Meters Guide

掌握计量器配置、聚合类型和事件筛选。

Complete Tutorial

从头开始构建一个完整的 AI 图像生成器，并实现基于使用量的计费。

Integration Guide

实施基于使用量计费在您的应用中的综合指南。