APIリソース
View Meter API References
View Meter API References
Create Meter
API 経由でメーターをプログラム的に作成します。
List Meters
アカウント内のすべてのメーターを取得します。
Get Meter
ID で特定のメーターの詳細を取得します。
Archive Meter
使用量の追跡を停止するためにメーターをアーカイブします。
Unarchive Meter
アーカイブされたメーターを復元して追跡を再開します。
メーターの作成
1
2
3
Filtering (Optional)
- ANDロジック：すべての条件が一致する必要があります
- ORロジック：任意の条件が一致する可能性があります
4
Create
設定を確認し、Create Meter をクリックします。
分析の表示
- Overview: 期間中の総使用量と使用量の推移
- Events: 受信した個々のイベントとそのメタデータ
- Customers: 顧客ごとの使用量合計と請求額
通貨ではなくクレジットでの請求
デフォルトでは、メーターは顧客に対してドル（または設定した通貨）で単位ごとに請求します。代わりに、顧客のクレジット残高から差し引くようにメーターを設定することもできます。これにより、使用量によって金銭的な請求が発生するのではなく、クレジットが消費されます。クレジットベースの差し引きには、同じ商品に紐付けられた Credit Entitlement が必要です。まずクレジットエンタイトルメントを作成し、その後メーターにリンクします。
クレジットベースの差し引きを使用すべきタイミング
クレジットを差し引くようメーターを構成する
1
Create a Credit Entitlement
まず、Products → Credits でクレジットエンタイトルメントを作成します。単位（例: “API Calls”、“Tokens”）、精度、ライフサイクル設定（有効期限、繰り越し、超過使用量）を定義します。詳細な手順はクレジットベースの請求ガイドを参照してください。
2
Create or Edit a Usage-Based Product
使用量ベースの製品に移動し、メーター構成セクションを開きます。
3
Add a Meter
**+**ボタンをクリックしてメーターを追加します。イベント名、集計タイプ、測定単位を通常通り設定します。
4
Enable 'Bill Usage in Credits'
5
Free Threshold and Credits
Free Threshold は、金額で請求されるメーターに適用され、クレジットで請求されるメーターには適用されません。メーターがクレジットで請求される場合、すべての単位がクレジットの差し引き対象になります。例: meter-units-per-credit が 1 の場合、2,500 回 API calls を行った顧客からは 2,500 credits が差し引かれます。
クレジット差し引きの仕組み
一度構成されると、差し引きパイプラインは自動で実行されます：- イベントが到着 — アプリケーションが Event Ingestion API を介して使用量イベントを送信します。
- メーターが集計 — イベントはメーター設定に従って集計されます（Count、Sum、Max、Last）。
- バックグラウンドワーカーが処理 — 1分ごとに、ワーカーが前回のチェックポイント以降に発生した新しいイベントを取得します。
- クレジットが差し引かれる — 集計された使用量は
meter_units_per_creditレートを使用してクレジットに変換され、FIFO 順序（有効期限が最も早い付与分から消費）で差し引かれます。 - 超過使用量が追跡される — 残高がゼロになると、それ以降の使用量は超過使用量として記録され、設定された動作（リセット時に免除、次回の請求書で請求、または不足残高として繰り越し）に従って処理されます。残高がなくなっても、Dodo Payments は使用をブロックしません。残高がゼロになった時点でアクセスを停止するには、アプリケーションで残高を確認してください。
複数メーター、1つのクレジットプール
同じ商品にある複数のメーターを、同じクレジットエンタイトルメントにリンクできます。すべてのメーターが1つの共有残高から差し引きます。 例: 2つのメーターを持つ AI プラットフォーム:text.generation— 1,000 tokens あたり 1 creditimage.generation— 画像1枚あたり 10 credits
List Customer Ledger
顧客のクレジット差し引き履歴全体を確認します。
Get Customer Balance
API経由で顧客の現在のクレジット残高を確認します。
トラブルシューティング
Events not appearing
Events not appearing
- イベント名が完全に一致していることを確認（大文字と小文字を区別）
- メーターのフィルターによってイベントが除外されていないことを確認
- 顧客 ID がアカウントに存在することを確認
- テストのために一時的にフィルターを無効にする
Aggregation not working
Aggregation not working
- Over Property がメタデータキーと完全に一致していることを確認
- 文字列ではなく数値を使用:
tokens: 150であり、tokens: "150"ではありません - すべてのイベントに必須プロパティを含める
Filters not working
Filters not working
- 大文字と小文字を正確に一致させる
- データ型に適した演算子を使用する
- イベントにフィルタリング対象のプロパティが含まれていることを確認する
Wrong usage totals
Wrong usage totals
- Events タブを確認して、実際に受信したイベント数を数える
- 集計タイプ（Count と Sum）を確認する
- Sum と Max では値が数値であることを確認する
次のステップ
Send Events
アプリケーションからメーターへ使用イベントの送信を開始します。
View Blueprints
一般的なユースケース向けの既存のメーター構成を使用します。