使用量に基づく請求は、顧客が実際に使用した分（APIコール、ストレージ、AIトークン、または定義した任意のメトリック）に対して請求することを可能にします。顧客は消費に対して支払い、固定料金はありません。
最適な用途: API、AIサービス、インフラストラクチャプラットフォーム、および使用量に応じて価値がスケールする製品。
仕組み
使用量イベントを送信
請求可能なアクションが発生したときに、アプリケーションがイベントを送信します。{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
メーターが使用量を集計
メーターは、Count、Sum、Max、またはLast集計を使用してイベントを請求可能な数量に集計します。
自動請求
単位ごとの価格と無料の閾値を設定します。顧客は各サイクルで自動的に請求されます。
コア概念
イベント
イベントは、アプリケーション内の使用アクションを表します。各イベントには以下が含まれます:
- イベント名: 使用の種類 (例:
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、HDは$0.08。
データ & 分析
処理されたデータ、実行されたクエリ、分析されたレコードに基づいて請求します。例: 10GB無料の後、$5/GB。
コミュニケーション
メッセージ、分、転送されたデータをカウントします。例: 送信されたSMSは$0.01。
次のステップ
