メインコンテンツへスキップ

Quick Start

自動トークン追跡で2分で開始できます。

API Reference - Events Ingestion

使用イベントを取り込むための完全なAPIドキュメント。

API Reference - Meters

課金用メーターを作成・設定する方法を学びましょう。

Usage-Based Billing Guide

メーターを使った従量課金の包括的ガイド。
SaaSアプリ、AIチャットボット、コンテンツ生成ツール、および従量課金が必要なLLM搭載アプリに最適です。

クイックスタート

自動 LLM トークン追跡を 2 分で始めましょう:
1

Install the SDK

Dodo Payments Ingestion Blueprintsをインストールする:
2

Get Your API Keys

2つのAPIキーが必要です:
  • Dodo Payments API キー: Dodo Payments ダッシュボード から取得します。
  • LLM プロバイダー API キー: AI SDK、OpenAI、Anthropic、Groq などから取得します。
APIキーは環境変数に安全に保存してください。バージョン管理にコミットしないでください。
3

Create a Meter in Dodo Payments

使用状況を追跡する前に、Dodo Paymentsダッシュボードでメーターを作成します:
  1. ログイン Dodo Payments Dashboard
  2. 移動 Products → Meters
  3. クリック “Create Meter”
  4. メーターを構成
    • Meter Name:わかりやすい名前を選択(例:「LLM Token Usage」)
    • Event Name:ユニークなイベント識別子を設定(例:llm.chat_completion
    • Aggregation Typesum を選びトークン数を合計
    • Over Property:追跡内容を選択:
      • inputTokens - 入力/プロンプトトークンを追跡
      • outputTokens - 出力/完了トークンを追跡(該当する場合は推論トークンも含む)
      • totalTokens - 入力 + 出力トークンの合計を追跡
ここで設定したEvent Nameは、SDKに渡す値と完全に一致する必要があります(大文字小文字を区別)。
詳しい手順については、Usage-Based Billing Guideを参照してください。
4

Track Token Usage

LLMクライアントをラップして自動で追跡を開始:
以上です!これで各API呼び出しが自動的にトークン使用量を追跡し、請求のためDodo Paymentsにイベントを送信します。

設定

トラッカー設定

アプリケーションの起動時に、次の必須パラメータでトラッカーを一度作成します:
apiKey
string
必須
Dodo PaymentsのAPIキー。API Keys pageから取得できます。
environment
string
必須
トラッカーの環境モード。
  • test_mode - 開発およびテストに使用
  • live_mode - 本番環境に使用
開発時には、プロダクション指標に影響を与えないよう常にtest_mode を使用してください。
eventName
string
必須
メーターをトリガーするイベント名。Dodo Paymentsのメーターで設定した値と完全に一致させる必要があります(大文字小文字を区別)。
このイベント名によって、追跡された使用量が請求計算用の正しいメーターに関連付けられます。

ラッパー設定

LLM クライアントをラップする際に、次のパラメータを提供します:
client
object
必須
LLMクライアントインスタンス(OpenAI、Anthropic、Groqなど)。
customerId
string
必須
課金対象のユニークな顧客識別子。Dodo Paymentsの顧客IDと一致させてください。
正確な顧客単位の請求を行うため、アプリケーションのユーザーIDまたは顧客IDを使用してください。
metadata
object
トラッキングイベントに追加できるオプションのデータ。フィルタリングや分析に便利です。

完全な設定例

自動追跡: SDKがバックグラウンドでトークン使用量を自動的に追跡し、レスポンスの変更は必要ありません。コードは元のプロバイダーSDKとまったく同じままです。

サポートされているプロバイダー

LLM ブループリントは、すべての主要な LLM プロバイダーおよび集約者とシームレスに連携します:
ユニバーサルLLMサポートのためにVercel AI SDKで使用状況を追跡します。
追跡メトリクス:
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • モデル名
AI SDK(たとえばGemini 2.5 Flashの思考モード)の推論対応モデルを使用する場合、推論トークンは正確な請求のために自動的にoutputTokensカウントに含まれます。
OpenRouterの統一APIで200以上のモデルのトークン使用量を追跡。
追跡メトリクス:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • モデル名
OpenRouterはOpenAI、Anthropic、Google、Metaなど多くのプロバイダーのモデルに単一APIでアクセスできます。
OpenAIのGPTモデルからのトークン使用量を自動で追跡。
追跡メトリクス:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • モデル名
AnthropicのClaudeモデルからのトークン使用量を追跡。
追跡メトリクス:
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • 計算済み totalTokens
  • モデル名
Groqによる超高速LLM推論を追跡。
追跡メトリクス:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • モデル名
Google GenAI SDK経由でGoogleのGeminiモデルのトークン使用量を追跡。
追跡メトリクス:
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • モデルバージョン
Gemini Thinking Mode: 思考/推論機能付きのGeminiモデル(例:Gemini 2.5 Pro)を使用する場合、SDKはthoughtsTokenCount(推論トークン)をoutputTokensに自動的に含め、総計算コストを正確に反映します。

高度な使用法

複数のプロバイダー

異なる LLM プロバイダー間で使用量を追跡するために、別々のトラッカーを使用します:
プロバイダーごとに異なるイベント名を使用して、メーターごとに使用状況を個別に追跡してください。

Express.js API 統合

Express.js API に LLM トラッキングを統合する完全な例:

追跡される内容

すべての LLM API 呼び出しは、自動的に Dodo Payments に使用イベントを送信し、次の構造を持ちます:

イベントフィールド

event_id
string
このイベント固有のユニーク識別子。SDKが自動生成します。Format: llm_[timestamp]_[random]
customer_id
string
ラップ時に提供した顧客ID。請求に使用されます。
event_name
string
メーターをトリガーするイベント名。トラッカー構成と一致します。
timestamp
string
イベントが発生したISO 8601タイムスタンプ。
metadata
object
トークン使用量および追加のトラッキングデータ:
  • inputTokens - 使用された入力/プロンプトトークンの数
  • outputTokens - 使用された出力/完了トークンの数(該当する場合は推論トークンを含む)
  • totalTokens - 合計トークン(入力 + 出力)
  • model - 使用されたLLMモデル(例:「gpt-4」)
  • provider - LLMプロバイダー(ラッパーメタデータに含まれる場合)
  • クライアントをラップした際に提供したカスタムメタデータ
推論トークン: 推論機能付きモデルでは、outputTokensに完了トークンと推論トークンの両方が自動的に含まれます。
Dodo Paymentsのメーターはmetadataフィールド(特にinputTokensoutputTokenstotalTokens)を使用して使用量と課金を計算します。

最終更新日 2026年4月1日