メインコンテンツへスキップ
使用量に基づく請求は、顧客が実際に使用した分（APIコール、ストレージ、AIトークン、または定義した任意のメトリック）に対して請求することを可能にします。顧客は消費に対して支払い、固定料金はありません。
Perfect for: 使用量に応じて価値がスケールする 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

メーターは Count、Sum、Max、Last の集計方式を使用してイベントを課金対象の量にまとめます。
3

Automatic Billing

単位ごとの価格と無料の閾値を設定します。顧客は各サイクルで自動的に請求されます。

​
コア概念

​
イベント

イベントは使用アクションを表します。各イベントには:
  • Event Name: 使用タイプ (例: api.call)
  • Customer ID: 利用した顧客
  • Metadata: 集計用の追加プロパティ

​
メーター

メーターは、イベントを請求可能な数量に集計します:
  • カウント: 総イベント数（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 回の無料後、1 回あたり $0.001。

AI Usage Tracking

トークン、生成、処理時間を追跡します。例: 標準画像 0.04、HD0.04、HD 0.08。

Data & Analytics

処理データ量、実行クエリ、分析レコードごとに課金。例: 10 GB の無料後は 1 GB あたり $5。

Communication

メッセージ、分数、転送データをカウント。例: 送信 SMS 1 件あたり $0.01。

​
次のステップ

Event Ingestion

アプリケーションから使用イベントを構造化し送信する方法を学びます。

Meters Guide

メーター構成、集計タイプ、イベントフィルタリングをマスターします。

Complete Tutorial

使用量課金を備えた AI 画像ジェネレーターをゼロから構築します。

Integration Guide

アプリケーションに使用量課金を実装するための総合ガイドです。
Last modified on March 3, 2026