使用量とコストAPI

Usage & Cost Admin APIは、組織の過去のAPI使用量とコストデータへのプログラムによるきめ細かなアクセスを提供します。このデータは、Claude Consoleの使用量ページおよびコストページで利用できる情報と同様のものです。

このAPIにより、Claudeの実装をより適切に監視、分析、最適化できます。

• 正確な使用量追跡： レスポンスのトークンカウントのみに頼るのではなく、正確なトークン数と使用パターンを取得できます
• コストの照合： 財務・経理チームのために、社内記録とAnthropicの請求を照合できます
• 製品のパフォーマンスと改善： システムへの変更によって改善されたかどうかを測定しながら製品のパフォーマンスを監視したり、アラートを設定したりできます
• レート制限の最適化： プロンプトキャッシングや特定のプロンプトなどの機能を最適化し、割り当てられた容量を最大限に活用できます
• 高度な分析： Consoleで利用できるものよりも深いデータ分析を実行できます

Claude Enterprise組織は、代わりに別のAPIでAnalytics APIキーを使用します。どのAPIが必要ですか？を参照してください。

どのAPIが必要ですか？

Anthropicは、組織が管理するClaude製品に応じて、2つのAPIを通じてコストと使用量のレポートを提供しています。

Claude Enterpriseの親組織はClaude Consoleに表示されず、Admin APIキーを持たないため、これらの組織にとってはAnalytics APIキーがこのデータにアクセスする唯一の手段です。各キーの種類の作成方法、およびClaude Enterpriseのコストデータがどのプランに適用されるかについては、Analytics APIを参照してください。

パートナーソリューション

主要なオブザーバビリティプラットフォームは、カスタムコードを書くことなくClaude APIの使用量とコストを監視できる、すぐに使える統合機能を提供しています。これらの統合機能は、API使用量を効果的に管理するためのダッシュボード、アラート、分析を提供します。

クイックスタート

組織の過去7日間の日次使用量を取得します。

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-08T00:00:00Z&\
ending_at=2025-01-15T00:00:00Z&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Usage API

/v1/organizations/usage_report/messagesエンドポイントを使用して、モデル、ワークスペース、サービスティアごとの詳細な内訳とともに、組織全体のトークン消費量を追跡します。

主要な概念

• タイムバケット： 固定間隔（1m、1h、または1d）で使用量データを集計します
• トークン追跡： キャッシュされていない入力、キャッシュされた入力、キャッシュ作成、および出力トークンを測定します
• フィルタリングとグループ化： APIキー、ワークスペース、モデル、サービスティア、コンテキストウィンドウ、データレジデンシー、またはスピード（ベータ）でフィルタリングし、これらのディメンションで結果をグループ化します
• サーバーツール使用： ウェブ検索などのサーバーサイドツールの使用量を追跡します

パラメータの詳細とレスポンススキーマの全容については、Usage APIリファレンスを参照してください。

基本的な例

モデル別の日次使用量

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

フィルタリング付きの時間別使用量

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-15T00:00:00Z&\
ending_at=2025-01-15T23:59:59Z&\
models[]=claude-opus-5&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

APIキーとワークスペースによる使用量のフィルタリング

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\
api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

データレジデンシー

inference_geoディメンションで使用量をグループ化およびフィルタリングすることで、データレジデンシー制御を追跡します。これは、組織全体の地理的ルーティングを検証するのに役立ちます。

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=inference_geo&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

特定のgeoでフィルタリングすることもできます。有効な値はglobal、us、およびnot_availableです。

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
inference_geos[]=us&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Fastモード（リサーチプレビュー）

speedディメンションでグループ化およびフィルタリングすることで、fastモードの使用量を追跡します。これは、標準モードとfastモードの使用量を監視するのに役立ちます。

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=speed&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

特定のスピードでフィルタリングすることもできます。有効な値はstandardとfastです。

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
speeds[]=fast&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

時間粒度の制限

Cost API

/v1/organizations/cost_reportエンドポイントを使用して、サービスレベルのコスト内訳をUSDで取得します。

主要な概念

• 通貨： すべてのコストはUSDで、最小単位（セント）の10進数文字列として報告されます
• コストの種類： トークン使用量、ウェブ検索、コード実行のコストを追跡します
• グループ化： 詳細な内訳のために、ワークスペースまたは説明（description）でコストをグループ化します。descriptionでグループ化すると、レスポンスにはmodelやinference_geoなどの解析済みフィールドが含まれます
• タイムバケット： 日次粒度のみ（1d）

パラメータの詳細とレスポンススキーマの全容については、Cost APIリファレンスを参照してください。

基本的な例

curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
group_by[]=workspace_id&\
group_by[]=description" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

ページネーション

両方のエンドポイントは、大規模なデータセット向けにページネーションをサポートしています。

1. 最初のリクエストを行います。
2. has_moreがtrueの場合、次のリクエストでnext_pageの値を使用します。
3. has_moreがfalseになるまで続けます。

# 最初のリクエスト
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

# レスポンスに含まれる内容: "has_more": true, "next_page": "page_xyz..."

# ページネーションを使用した次のリクエスト
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7&\
page=page_xyz..." \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

一般的なユースケース

Claude Cookbookで詳細な実装を確認してください。

• 日次使用量レポート： トークン消費の傾向を追跡します
• コスト配分： チャージバックのためにワークスペースごとに費用を割り当てます
• キャッシュ効率： プロンプトキャッシングを測定し最適化します
• 予算監視： 支出しきい値のアラートを設定します
• CSVエクスポート： 財務チーム向けのレポートを生成します

よくある質問

データの鮮度はどの程度ですか？

使用量とコストのデータは通常、APIリクエストの完了から5分以内に表示されますが、遅延がそれより長くなる場合もあります。

推奨されるポーリング頻度はどのくらいですか？

このAPIは、継続的な使用において1分に1回のポーリングをサポートしています。短時間のバースト（たとえば、ページネーションされたデータのダウンロード）では、より頻繁なポーリングも許容されます。頻繁な更新が必要なダッシュボードでは、結果をキャッシュしてください。

コード実行の使用量はどのように追跡しますか？

コード実行のコストは、コストエンドポイントでdescriptionフィールドのCode Execution Usageの下にグループ化されて表示されます。コード実行は使用量エンドポイントには含まれません。

Priority Tierの使用量はどのように追跡しますか？

使用量エンドポイントでservice_tierによってフィルタリングまたはグループ化し、priorityの値を探してください。Priority Tierのコストはコストエンドポイントでは利用できません。

playgroundの使用量はどうなりますか？

Claude Consoleのplayground（およびそれ以前のレガシーWorkbench）からのAPI使用量はAPIキーに関連付けられていないため、そのディメンションでグループ化した場合でもapi_key_idはnullになります。

デフォルトワークスペースはどのように表されますか？

デフォルトワークスペースに帰属する使用量とコストは、workspace_idの値がnullになります。

Claude Codeのユーザーごとのコスト内訳はどのように取得しますか？

Claude Code Analytics APIを使用してください。これは、多数のAPIキーでコストを分割する際のパフォーマンス上の制限なしに、ユーザーごとの推定コストと生産性メトリクスを提供します。多数のキーを使用する一般的なAPI使用量については、Usage APIを使用して、コストの代替指標としてトークン消費量を追跡してください。

関連項目

Usage APIとCost APIを使用して、ユーザーにより良い体験を提供し、コストを管理し、レート制限を維持してください。その他の機能の詳細については、以下を参照してください。

• Admin API
• Admin APIリファレンス
• Analytics API - 組織に必要な分析APIとキーの種類
• 料金
• プロンプトキャッシング - キャッシングでコストを最適化
• バッチ処理 - バッチリクエストで50%割引
• レート制限 - 使用量ティアを理解する
• Rate Limits API - 設定されたレート制限を読み取る
• データレジデンシー - 推論の地理的場所を制御する