The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
使用量とコスト管理APIは、組織の過去のAPI使用量とコストデータへのプログラム的で詳細なアクセスを提供します。このデータは、Anthropic Consoleの使用量およびコストページで利用可能な情報と類似しています。 このAPIにより、Claudeの実装をより良く監視、分析、最適化できます：
  • 正確な使用量追跡： レスポンストークンカウントのみに依存するのではなく、正確なトークン数と使用パターンを取得
  • コスト照合： 財務・会計チーム向けに内部記録とAnthropic請求を照合
  • 製品パフォーマンスと改善： システムへの変更が改善されたかを測定しながら製品パフォーマンスを監視、またはアラートを設定
  • レート制限と優先ティアの最適化： プロンプトキャッシュや特定のプロンプトなどの機能を最適化して、割り当てられた容量を最大限活用、または専用容量を購入
  • 高度な分析： Consoleで利用可能なものよりも深いデータ分析を実行
管理APIキーが必要このAPIは管理APIの一部です。これらのエンドポイントには、標準のAPIキーとは異なる管理APIキー（sk-ant-admin...で始まる）が必要です。管理者ロールを持つ組織メンバーのみが、Anthropic Consoleを通じて管理APIキーをプロビジョニングできます。

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

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

Datadog

自動トレースと監視を備えたLLM可観測性

Grafana Cloud

すぐに使えるダッシュボードとアラートを備えた簡単なLLM可観測性のためのエージェントレス統合

Honeycomb

OpenTelemetryを通じた高度なクエリと可視化

​
クイックスタート

過去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キー、ワークスペース、モデル、サービスティア、またはコンテキストウィンドウでフィルタリングし、これらの次元で結果をグループ化
  • サーバーツール使用量: ウェブ検索などのサーバーサイドツールの使用量を追跡
完全なパラメータの詳細とレスポンススキーマについては、使用量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-sonnet-4-20250514&\
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を確認してください。

​
時間粒度制限

粒度デフォルト制限最大制限使用例
1m60バケット1440バケットリアルタイム監視
1h24バケット168バケット日次パターン
1d7バケット31バケット週次/月次レポート

​
コストAPI

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

​
主要概念

  • 通貨: すべてのコストはUSDで、最小単位（セント）の小数文字列として報告
  • コストタイプ: トークン使用量、ウェブ検索、コード実行コストを追跡
  • グループ化: 詳細な内訳のためにワークスペースまたは説明でコストをグループ化
  • 時間バケット: 日次粒度のみ（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"

​
ページネーション

両方のエンドポイントは大きなデータセットのページネーションをサポートしています：
  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"

​
一般的な使用例

anthropic-cookbookで詳細な実装を探索：
  • 日次使用量レポート: トークン消費トレンドを追跡
  • コスト配分: チャージバックのためにワークスペース別に費用を配分
  • キャッシュ効率: プロンプトキャッシュを測定し最適化
  • 予算監視: 支出しきい値のアラートを設定
  • CSV エクスポート: 財務チーム向けレポートを生成

​
よくある質問

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

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

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

APIは持続的な使用のために1分に1回のポーリングをサポートしています。短期間のバースト（例：ページ分割されたデータのダウンロード）の場合、より頻繁なポーリングが許可されます。頻繁な更新が必要なダッシュボードの結果をキャッシュしてください。

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

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

​
優先ティア使用量を追跡するにはどうすればよいですか？

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

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

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

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

デフォルトワークスペースに帰属する使用量とコストは、workspace_idにnull値を持ちます。

​
関連項目

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