使用状況とコスト API

使用量とコストAPI

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

Usage & Cost Admin API は、組織の過去の API 使用状況とコストデータへのプログラマティックで詳細なアクセスを提供します。このデータは、Claude Console の使用状況およびコストページで利用可能な情報と同様です。

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

正確な使用状況追跡： レスポンストークンカウントのみに依存するのではなく、正確なトークン数と使用パターンを取得します
コスト調整： 内部記録を Anthropic の請求と照合して、財務および会計チームをサポートします
製品パフォーマンスと改善： 製品パフォーマンスを監視しながら、システムへの変更がそれを改善したかどうかを測定するか、アラートを設定します
レート制限および優先度層の最適化： プロンプトキャッシングや特定のプロンプトなどの機能を最適化して、割り当てられた容量を最大限に活用するか、専用容量を購入します。
高度な分析： Console で利用可能なものより深いデータ分析を実行します

Admin API キーが必要です

この API は Admin API の一部です。これらのエンドポイントには、標準 API キーとは異なる Admin API キー（sk-ant-admin... で始まる）が必要です。管理者ロールを持つ組織メンバーのみが、Claude Console を通じて Admin API キーをプロビジョニングできます。

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

主要な可観測性プラットフォームは、カスタムコードを記述することなく Claude API の使用状況とコストを監視するための、すぐに使用できる統合を提供しています。これらの統合は、ダッシュボード、アラート、分析を提供して、API 使用状況を効果的に管理するのに役立ちます。

CloudZero

コストの追跡と予測のためのクラウドインテリジェンスプラットフォーム

クイックスタート

過去 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

統合用に User-Agent ヘッダーを設定します

統合を構築している場合は、User-Agent ヘッダーを設定して、使用パターンを理解するのに役立てます：

User-Agent: YourApp/1.0.0 (https://yourapp.com)

使用状況 API

/v1/organizations/usage_report/messages エンドポイントを使用して、モデル、ワークスペース、サービス層による詳細な内訳を含む、組織全体のトークン消費を追跡します。

主要な概念

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

完全なパラメータの詳細と応答スキーマについては、使用状況 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_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-4-7&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

組織の API キー ID を取得するには、API キーのリストエンドポイントを使用します。

組織のワークスペース ID を取得するには、ワークスペースのリストエンドポイントを使用するか、Anthropic Console で組織のワークスペース ID を見つけます。

データレジデンシー

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

特定の地域にフィルタリングすることもできます。有効な値は 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

2026 年 2 月より前にリリースされたモデル（Claude Opus 4.6 より前）は inference_geo リクエストパラメータをサポートしていないため、使用状況レポートはこのディメンションに対して "not_available" を返します。inference_geos[] のフィルタ値として not_available を使用して、これらのモデルをターゲットにできます。

高速モード（ベータ：研究プレビュー）

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

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: fast-mode-2026-02-01" \
  --header "x-api-key: $ADMIN_API_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" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: fast-mode-2026-02-01" \
  --header "x-api-key: $ADMIN_API_KEY"

speeds[] フィルタと speed group_by 値の両方に、fast-mode-2026-02-01 ベータヘッダーが必要です。

時間粒度の制限

粒度	デフォルト制限	最大制限	ユースケース
`1m`	60 バケット	1440 バケット	リアルタイム監視
`1h`	24 バケット	168 バケット	日次パターン
`1d`	7 バケット	31 バケット	週次/月次レポート

コスト API

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

主要な概念

通貨： すべてのコストは USD で、最小単位（セント）の 10 進文字列として報告されます
コストタイプ： トークン使用状況、Web 検索、およびコード実行コストを追跡します
グループ化： ワークスペースまたは説明でコストをグループ化して、詳細な内訳を取得します。description でグループ化する場合、応答には model や inference_geo などの解析されたフィールドが含まれます
時間バケット： 日次粒度のみ（1d）

完全なパラメータの詳細と応答スキーマについては、コスト 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

ページネーション

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

初期リクエストを実行します
has_more が true の場合、次のリクエストで next_page 値を使用します
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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_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..." \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

一般的なユースケース

Claude Cookbook で詳細な実装を確認します：

日次使用状況レポート： トークン消費トレンドを追跡します
コスト配分： チャージバック用にワークスペース別に費用を配分します
キャッシュ効率： プロンプトキャッシングを測定および最適化します
予算監視： 支出しきい値のアラートを設定します
CSV エクスポート： 財務チーム向けのレポートを生成します

よくある質問

データはどのくらい新しいですか？

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

推奨されるポーリング頻度は？

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

コード実行の使用状況を追跡するにはどうすればよいですか？

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

優先度層の使用状況を追跡するにはどうすればよいですか？

使用状況エンドポイントで service_tier でフィルタリングまたはグループ化し、priority 値を探します。優先度層のコストはコストエンドポイントでは利用できません。

Workbench の使用状況はどうなりますか？

Workbench からの API 使用状況は API キーに関連付けられていないため、その次元でグループ化する場合でも api_key_id は null になります。

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

デフォルトワークスペースに起因する使用状況とコストは、workspace_id に対して null 値を持ちます。

Claude Code のユーザー別のコスト内訳を取得するにはどうすればよいですか？

Claude Code Analytics API を使用します。これは、多くの API キーでコストを分割する場合のパフォーマンス制限なしに、ユーザー別の推定コストと生産性メトリクスを提供します。多くのキーを持つ一般的な API 使用状況の場合、使用状況 API を使用してトークン消費をコストプロキシとして追跡します。

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

クイック スタート

使用状況 API

主要な概念

基本的な例

モデル別の日次使用状況

フィルタリング付きの時間単位の使用状況

API キーとワークスペースで使用状況をフィルタリングします

データ レジデンシー

高速モード（ベータ：研究プレビュー）

時間粒度の制限

コスト API

主要な概念

基本的な例

ページネーション

一般的なユース ケース

よくある質問

データはどのくらい新しいですか？

推奨されるポーリング頻度は？

コード実行の使用状況を追跡するにはどうすればよいですか？

優先度層の使用状況を追跡するにはどうすればよいですか？

Workbench の使用状況はどうなりますか？

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

Claude Code のユーザー別のコスト内訳を取得するにはどうすればよいですか？

関連項目

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

クイックスタート

データレジデンシー

一般的なユースケース

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