Claude Platform Docs
  • メッセージ
  • マネージドエージェント
  • 管理

Search...
⌘K
組織
Admin APIワークスペース
認証
概要Admin APIキーの作成Workload Identity FederationAPI経由でWIFを管理WIFリファレンス
モニタリング
Usage and Cost APIRate Limits APIAnalytics APIClaude Code Analytics APISpend Limits API
データとコンプライアンス
データレジデンシーAPIとデータ保持アクセスの透明性
Compliance API
概要アクセスの取得アクティビティフィードチャット、ファイル、プロジェクト組織、ユーザー、ロール、グループ、設定統合の設計エラーFAQ

Log in
Usage and Cost API
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Claude Platform Docs

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Claude on Google Cloud

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
管理/モニタリング

Usage and Cost API

Usage & Cost Admin APIを使用して、組織のAPI使用状況とコストデータにプログラムからアクセスします。


Admin APIは個人アカウントではご利用いただけません。 チームメンバーと共同作業を行い、メンバーを追加するには、Console → Settings → Organization で組織を設定してください。

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

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

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

Admin APIキーが必要です。 これらのエンドポイントには、標準のClaude APIキーとは異なるAdmin APIキーが必要です。組織タイプに応じた作成場所と選択すべきスコープについては、Admin APIキーの作成を参照してください。

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



AWS上のClaude Platform： プログラムによるUsage and Cost APIエンドポイントは現在利用できません。代わりに、Claude ConsoleのUsageページとCostページで使用状況とコストデータを確認してください。

どのAPIが必要ですか？

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

組織APIキーの種類
Claude Console（Claude Platform）このページで説明しているUsage and Cost Admin APIAdmin APIキー（sk-ant-admin01-...）
Claude Enterprise（claude.ai）Claude Enterprise Analytics APIのコストおよび使用状況エンドポイントAnalytics APIキー

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

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

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


CloudZero


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


Datadog


自動トレーシングと監視を備えたLLMオブザーバビリティ


Grafana Cloud


すぐに使えるダッシュボードとアラートを備えた、簡単なLLMオブザーバビリティのためのエージェントレス統合

Honeycomb


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


Vantage


LLMのコストと使用状況のオブザーバビリティのためのFinOpsプラットフォーム

クイックスタート

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

cURL
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: $ANTHROPIC_ADMIN_KEY"


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

統合を構築している場合は、使用パターンの把握に役立てるため、User-Agentヘッダーを設定してください。

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

Usage API

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

主要な概念

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

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

基本的な例

モデル別の日次使用状況

cURL
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: $ANTHROPIC_ADMIN_KEY"

フィルタリングを使用した時間別使用状況

cURL
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-8&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

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

cURL
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: $ANTHROPIC_ADMIN_KEY"


組織のAPIキーIDを取得するには、List API Keysエンドポイントを使用してください。

組織のワークスペースIDを取得するには、List Workspacesエンドポイントを使用するか、Claude Consoleで組織のワークスペースIDを確認してください。

データレジデンシー

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

cURL
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: $ANTHROPIC_ADMIN_KEY"

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

cURL
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: $ANTHROPIC_ADMIN_KEY"


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

高速モード（リサーチプレビュー）

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

cURL
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: $ANTHROPIC_ADMIN_KEY"

特定の速度にフィルタリングすることもできます。有効な値はstandardとfastです。

cURL
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: $ANTHROPIC_ADMIN_KEY"


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

時間粒度の制限

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

Cost API

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

主要な概念

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

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



Priority Tierのコストは異なる請求モデルを使用しており、コストエンドポイントには含まれていません。代わりに、使用状況エンドポイントを通じてPriority Tierの使用状況を追跡してください。

基本的な例

cURL
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: $ANTHROPIC_ADMIN_KEY"

ページネーション

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

  1. 最初のリクエストを実行します
  2. has_moreがtrueの場合、次のリクエストでnext_pageの値を使用します
  3. has_moreがfalseになるまで続けます
cURL
# 最初のリクエスト
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: $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..." \
  --header "anthropic-version: 2023-06-01" \
  --header "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のコストはコストエンドポイントでは利用できません。

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

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

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

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

Claude Codeのユーザー別コスト内訳を取得するには？

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

関連情報

Usage and Cost APIは、ユーザーにより良い体験を提供し、コストを管理し、レート制限を維持するのに役立ちます。これらの他の機能について詳しくは以下を参照してください。

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

Was this page helpful?

  • どのAPIが必要ですか？
  • パートナーソリューション
  • クイックスタート
  • Usage API
  • 主要な概念
  • 基本的な例
  • 時間粒度の制限
  • Cost API
  • 主要な概念
  • 基本的な例
  • ページネーション
  • 一般的なユースケース
  • よくある質問
  • データの鮮度はどの程度ですか？
  • 推奨されるポーリング頻度は？
  • コード実行の使用状況を追跡するには？
  • Priority Tierの使用状況を追跡するには？
  • Workbenchの使用状況はどうなりますか？
  • デフォルトワークスペースはどのように表現されますか？
  • Claude Codeのユーザー別コスト内訳を取得するには？
  • 関連情報