メインコンテンツへスキップ
メーターは生イベントを課金対象の数量に変換します。イベントをフィルタリングし、集計関数（Count、Sum、Max、Last）を適用して顧客ごとの使用量を算出します。
イベント名、集計タイプ、フィルタリングオプションを示すメーター作成インターフェース

​
APIリソース

​
メーターの作成

1

Basic Information

​
Meter Name
string
必須
説明的な名前（例: «API Requests», «Token Usage»）
​
Event Name
string
必須
一致させる正確なイベント名（大文字小文字を区別）。例: api.call、image.generated
2

Aggregation

​
Aggregation Type
string
必須
イベントの集計方法を選択:
  • Count: イベントの総数（API 呼び出し、アップロードなど）
  • Sum: 数値を合計（トークン、バイトなど）
  • Max: 期間内の最大値（ピークユーザー数など）
  • Last: 最新の値
​
Over Property
string
Count を除くすべてのタイプで必須となる集計対象のメタデータキー。例: tokens、bytes、duration_ms
​
Measurement Unit
string
必須
請求書上の単位ラベル。例: calls、tokens、GB、hours
3

Filtering (Optional)

イベントフィルタリング
カウントされるイベントをフィルタリングする条件を追加します：
  • ANDロジック：すべての条件が一致する必要があります
  • ORロジック：任意の条件が一致する可能性があります
比較演算子：等しい、等しくない、大きい、小さい、含むフィルタリングを有効にし、ロジックを選択し、プロパティキー、比較演算子、値を使って条件を追加します。
4

Create

設定を確認し、Create Meter をクリックします。

​
分析の表示

メーター分析
メーターダッシュボードには次の情報が表示されます：
  • 概要：総使用量と使用量チャート
  • イベント：受信した個々のイベント
  • 顧客：顧客ごとの使用量と料金

​
通貨ではなくクレジットでの請求

デフォルトでは、メーターはドル（または構成された通貨）で単価請求します。代わりに、メーターをクレジット残高を差し引くよう構成することができます。これにより、使用量が金銭的請求を発生させるのではなくクレジットを消費します。
クレジットベースの差し引きには、同じ製品に紐づいたクレジット権利が必要です。先にクレジットを作成し、その後メーターとリンクさせてください。

​
クレジットベースの差し引きを使用すべきタイミング

シナリオ通常（通貨）クレジットベース
単純な単価課金（$0.01/コール）✅ 最適不要なオーバーヘッド
前払いのクレジットパック（10Kトークンを購入し、時間をかけて利用）❌ 表現不可✅ 最適
サブスクリプションに含まれたバンドル利用（Proプランに100Kコール含む）無料しきい値で対応可能✅ より良い - クレジットは繰越され、有効期限があり、ポータルに表示
複数メーター製品でクレジットプールを共有❌ 各メーターが別請求✅ すべてのメーターが単一残高から差し引き

​
クレジットを差し引くようメーターを構成する

1

Create a Credit Entitlement

まず、製品 → クレジットでクレジットを作成します。単位（例：「API Calls」、「Tokens」）、精度、ライフサイクル設定（有効期限、繰越、超過）を定義してください。詳細な手順はクレジットベースの請求ガイドを参照してください。
2

Create or Edit a Usage-Based Product

使用量ベースの製品に移動し、メーター構成セクションを開きます。
3

Add a Meter

**+**ボタンをクリックしてメーターを追加します。イベント名、集計タイプ、測定単位を通常通り設定します。
4

Enable 'Bill Usage in Credits'

メーター構成でクレジットで使用量を請求をオンにします。これによりクレジット設定が表示されます：
クレジットでの請求が有効になったメーター構成
​
Credit Entitlement
string
必須
このメーターが差し引く対象のクレジット権利を選択します。
​
Meter units per credit
number
必須
1クレジットを差し引くために必要な使用単位数。例えば：
  • 1 = 各メーターイベントで1クレジット差し引き
  • 100 = 100イベントで1クレジット差し引き
  • 1000 = 1,000 APIコールで1クレジット消費
5

Set the Free Threshold

無料しきい値は引き続き適用されます - このしきい値未満のイベントはクレジットを差し引きません。例：無料しきい値1,000、メーター単位あたりクレジット1の場合：
  • 顧客が2,500 APIコールを使用
  • 最初の1,000は無料
  • 残り1,500は残高から1,500クレジット差し引き

​
クレジット差し引きの仕組み

一度構成されると、差し引きパイプラインは自動で実行されます：
  1. イベントが到着 - アプリケーションがイベント取り込みAPI経由で使用イベントを送信
  2. メーターが集計 - イベントはメーター構成（Count、Sum、Max、Last）に従って集計されます
  3. バックグラウンドワーカーが処理 - 毎分、ワーカーが最後のチェックポイント以降の新しいイベントを取得
  4. クレジットが差し引かれる - 集計された使用量はmeter_units_per_creditレートでクレジットに変換され、FIFO順（最も古いクレジットから消費）で差し引かれます
  5. 超過が記録 - 残高がゼロになり超過が有効化されている場合、使用は継続され設定された動作（リセットで免除、次回請求で課金、赤字として繰越）に従って処理されます
クレジット差し引きは非同期で実行されます（約1分ごと）。イベント取り込みと残高差し引きの間に短い遅延が生じる可能性があります。この遅延に対応するようアプリケーションを設計し、個々のリクエストのアクセス制御でリアルタイムの残高チェックに頼らないでください。

​
複数メーター、1つのクレジットプール

同一製品に複数のメーターを同じクレジット権利にリンクできます。すべてのメーターが共有残高から差し引きます。 例：2つのメーターを持つAIプラットフォーム：
  • text.generation - 1,000トークンあたり1クレジット
  • image.generation - 画像1枚あたり10クレジット
どちらも「AI Credits」プールから差し引かれます。顧客はポータルで単一の統合残高を確認できます。
異なるmeter_units_per_creditレートをメーター間で使用して、相対的なコストを表現できます。高価な操作（画像生成）は安価な操作（テキスト補完）よりも少ないメーター単位でクレジットが消費されます。

List Customer Ledger

顧客のクレジット差し引き履歴全体を確認します。

Get Customer Balance

API経由で顧客の現在のクレジット残高を確認します。

​
トラブルシューティング

  • イベント名は完全一致（大文字小文字を区別）であること
  • メーターのフィルターがイベントを除外していないか確認
  • 顧客IDが存在するか検証
  • テストのために一時的にフィルターを無効化
  • Over Propertyがメタデータキーと完全一致しているか確認
  • 文字列ではなく数値を使用：tokens: 150（文字列ではない）
  • 必須プロパティがすべてのイベントに含まれていること
  • 大文字小文字を区別して一致
  • データ型に合った演算子を使用
  • フィルター対象プロパティがイベントに含まれていることを確認
  • 実際に受信したイベント数をEventsタブで確認
  • 集計タイプ（Count vs Sum）を検証
  • Sum/Maxでは値が数値であることを確認

​
次のステップ

Send Events

アプリケーションからメーターへ使用イベントの送信を開始します。

View Blueprints

一般的なユースケース向けの既存のメーター構成を使用します。