> ## 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トークン、または定義した任意のメトリック）に対して請求することを可能にします。顧客は消費に対して支払い、固定料金はありません。
**Perfect for**: 使用量に応じて価値がスケールする API、AI サービス、インフラプラットフォーム、およびあらゆる製品に適しています。
## 仕組み
課金対象アクションが発生したらアプリケーションがイベントを送信します。
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
メーターは Count、Sum、Max、Last の集計方式を使用してイベントを課金対象の量にまとめます。
単位ごとの価格と無料の閾値を設定します。顧客は各サイクルで自動的に請求されます。
## コア概念
### イベント
イベントは使用アクションを表します。各イベントには:
* **Event Name**: 使用タイプ (例: `api.call`)
* **Customer ID**: 利用した顧客
* **Metadata**: 集計用の追加プロパティ
### メーター
メーターは、イベントを請求可能な数量に集計します:
* **カウント**: 総イベント数（APIコール）
* **合計**: 値を加算（総バイト数）
* **最大**: 最高値（ピークユーザー数）
* **最新**: 最も最近の値
### 使用量に基づく価格設定のある製品
単位ごとの価格とオプションの無料閾値を設定します:
**例**: 2,500コール - 1,000無料 = 1,500 × $0.02 = $30.00
### クレジットベースの差し引き
ドル単位で課金する代わりに、メーターを構成して顧客の[クレジット残高](/features/credit-based-billing)から差し引かれるようにできます。クレジットは各請求サイクルでリフレッシュされ、超過料金より前に適用されます。
## クイックスタート
ダッシュボードで: **Meters** → **Create Meter**
1. イベント名を設定 (例: `api.call`)
2. 集計方式を選択 (Count、Sum、Max、Last)
3. 必要に応じてフィルターを追加
価格設定された製品にメーターをリンク:
1. **Usage-Based Billing** を選択
2. 使用するメーターを選択
3. 単価と無料閾値を設定
```javascript theme={null}
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" }
}]
})
});
```
メーターのダッシュボードでイベントと使用量集計を確認します。顧客は各サイクルで自動的に請求されます。
## ユースケース
API コール、コンピュート時間、帯域幅、ストレージを追跡します。例: 10,000 回の無料後、1 回あたり \$0.001。
トークン、生成、処理時間を追跡します。例: 標準画像 $0.04、HD $0.08。
処理データ量、実行クエリ、分析レコードごとに課金。例: 10 GB の無料後は 1 GB あたり \$5。
メッセージ、分数、転送データをカウント。例: 送信 SMS 1 件あたり \$0.01。
## 次のステップ
アプリケーションから使用イベントを構造化し送信する方法を学びます。
メーター構成、集計タイプ、イベントフィルタリングをマスターします。
使用量課金を備えた AI 画像ジェネレーターをゼロから構築します。
アプリケーションに使用量課金を実装するための総合ガイドです。