使用量とコスト API

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

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

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

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

主要なオブザーバビリティプラットフォームは、カスタムコードを書くことなく 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

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

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" \
  --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-6&\
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"

データレジデンシー

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"

時間粒度の制限

Cost API

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

主要な概念

• 通貨: すべてのコストは USD で、最小単位（セント）の小数文字列として報告
• コストタイプ: トークン使用量、ウェブ検索、コード実行のコストを追跡
• グルーピング: 詳細な内訳のためにワークスペースまたは説明でコストをグループ化。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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_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" \
  --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 分に 1 回のポーリングをサポートしています。短いバースト（例：ページネーションされたデータのダウンロード）では、より頻繁なポーリングが許容されます。頻繁な更新が必要なダッシュボードでは、結果をキャッシュしてください。

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

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

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

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

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

Workbench からの API 使用量は API キーに関連付けられていないため、そのディメンションでグループ化しても api_key_id は null になります。

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

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

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

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

関連情報

使用量とコスト API は、ユーザーにより良い体験を提供し、コストを管理し、レート制限を維持するのに役立ちます。これらの他の機能について詳しく学んでください：

• Admin API の概要
• Admin API リファレンス
• 料金
• プロンプトキャッシング - キャッシングでコストを最適化
• バッチ処理 - バッチリクエストで 50% 割引
• レート制限 - 使用量ティアを理解する
• データレジデンシー - 推論の地理的位置を制御