跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

基于使用的计费让您可以根据客户实际使用的情况进行收费——API 调用、存储、AI 令牌或您定义的任何指标。客户为消费付费，而不是固定费用。
适用于：API、AI 服务、基础设施平台以及任何价值随使用规模扩大而提升的产品。

​
工作原理

1

Send Usage 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）
  • 客户 ID：谁使用了它
  • 元数据：用于聚合的附加属性

​
计量器

计量器将事件汇总为可计费数量：
  • 计数：总事件（API 调用）
  • 总和：添加值（总字节）
  • 最大值：最高值（峰值用户）
  • 最后：最近值
创建计量接口

​
具有使用定价的产品

设置每单位的定价和可选的免费阈值：
定价配置
示例：2,500 次调用 - 1,000 次免费 = 1,500 × 0.02=0.02 = 30.00

​
基于信用的扣减

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

​
快速入门

1

Create a Meter

在控制面板中：Meters → Create Meter
  1. 设置事件名称（例如 api.call）
  2. 选择聚合方式（Count、Sum、Max、Last）
  3. 添加可选筛选条件
2

Add to Product

将计量器与具有定价的产品关联：
将计量添加到产品
  1. 选择 Usage-Based Billing
  2. 选择您的计量器
  3. 设置每单位价格和免费额度
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

计量仪表板
查看您的计量器仪表盘以了解事件和使用量聚合情况。客户将自动在每个周期计费。

​
用例

APIs & Infrastructure

跟踪 API 调用、计算小时数、带宽、存储。示例：前 10,000 次免费，之后每次 $0.001。

AI Usage Tracking

跟踪令牌、生成次数、处理时间。示例：每张标准图像 0.04，高画质0.04，高画质 0.08。

Data & Analytics

按处理数据量、执行查询、分析记录收费。示例：前 10 GB 免费，之后每 GB $5。

Communication

统计消息、分钟数、传输数据。示例：每条短信 $0.01。

​
下一步

Event Ingestion

了解如何构建并从您的应用发送使用事件。

Meters Guide

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

Complete Tutorial

从头开始构建具有使用量计费的完整 AI 图像生成器。

Integration Guide

实施使用量计费的综合指南。
Last modified on April 20, 2026