AI道場 / ニュース

Usage and Cost Analytics APIとは？Claudeの費用を利用者別に集計

2026年11月3日・Anthropicの発表より・AI道場 編集部

Anthropicは、組織のトークン使用量と費用をモデル別・ワークスペース別・APIキー別などに集計できるUsage and Cost Analytics APIをベータ版で公開しました。対象はClaude ConsoleとClaude Enterpriseの組織です。従来のUsage and Cost APIはレガシー扱いになりましたが、引き続きサポートされます。

Usage and Cost Analytics APIとは

Usage and Cost Analytics APIは、組織で使ったClaudeのトークン量と費用の履歴をプログラムから取得するためのAPIです。現在はベータ版で、次の2種類の窓口（エンドポイント）があります。

• /v1/organizations/analytics/usage：トークン数とリクエスト数を返す
• /v1/organizations/analytics/cost：費用を米ドルで返す

Claude Consoleの組織であれば、取得できるデータはConsoleのUsageページやCostページに表示される内容に近いものです。

何が変わるか

集計の切り口を選べます。 モデル、ワークスペース、APIキーのほか、各リクエストの背後にいるユーザーやサービスアカウント別に結果を分けられます。ただし、APIキーの軸（api_key_id）が適用されるのはClaude Consoleの組織だけです。適用されない組織では全行でnullになり、この軸での絞り込みは何にも一致しません。

Claude ConsoleとClaude Enterpriseで同じ作りになります。 エンドポイント、パラメーター、応答の項目が共通なので、連携を一度作れば両方の組織に使えます。

既存のAPIはレガシー扱いになります。 Usage and Cost APIと、Claude Enterprise Analytics APIのusage_report、cost_report、user_usage_report、user_cost_reportが対象です。いずれも引き続きサポートされます。

仕組み

応答の各行は3つの部分でできています。starting_atとending_atが対象期間、groupが集計の軸、usageまたはcostが数値です。

• 軸： group_by[]で指定した軸ごとに行が分かれます。指定しない軸の値はnullになります
• 絞り込み： models[]のように条件を指定できます。条件ごとに指定できる値は最大100個です
• 時間の区切り： time_bucket_widthで日・時間・分単位に分けられます。区切りはUTC基準で、使用量のない区切りには行が返りません
• 並び順： 既定では指定した指標の大きい順です。時系列にしたいときはorder_by=timeを指定します

「誰の利用か」を示すのがactorという軸です。ユーザー、サービスアカウント、クラウド側のID、またはどれにも当たらない場合はAPIキー自体がここに入ります。どのIDにも結び付けられない利用はactorがnullになります。

費用のエンドポイントでは、amountが割引後でクレジット適用前の金額、list_amountが定価での金額です。金額はセント単位の文字列で、たとえば「41280.000000」は412.80ドルを意味します。cost_typeとtoken_typeを軸に加えると、費用の種類やトークンの種類ごとの内訳も取得できます。

Priority Tierの契約枠で処理されたリクエストは、トークン費用がゼロとして集計されます。契約料金は別請求で、このデータには含まれません。

使い方・始め方

Admin APIは個人アカウントでは利用できないため、先にClaude Consoleで組織を設定します。

• 認証情報を用意する： Claude Consoleの組織は、Admin APIキーか、org:adminスコープのOAuthトークンなどを使います。Claude Enterpriseの組織は、Analytics APIが有効になった後にプライマリオーナーがclaude.aiで作成した、read:analyticsスコープのキーを使います
• ヘッダーを付ける： すべてのリクエストに、anthropic-beta: analytics-usage-cost-2026-08-24とanthropic-versionを付けます。SDKとant CLIなら両方を自動で送り、続きのページも自動で取得します
• 期間と軸を指定する： たとえば期間、日単位の区切り、モデル別の集計を指定すると、モデルと日の組み合わせごとに結果が返ります

Admin APIキーを使う場合、公式ドキュメントはデータ収集用サービス専用のキーを発行し、シークレット管理の仕組みに保管して定期的に更新するよう勧めています。可能であれば、短期間だけ有効なトークンを使えるWorkload Identity Federationが推奨されています。

期間とデータ反映の注意点

指定できる開始日は2026年1月1日以降で、かつ過去365日以内です。1回のリクエストで指定できる期間は最大31日で、それより長い期間はリクエストを分けます。分単位の区切りを使う場合は最大24時間です。

データは通常4時間以内に反映され、最大で24時間かかることがあります。応答のdata_refreshed_atより後の利用分は、欠けているか一部のみの可能性があります。

数値は、遅れて届くイベントや照合処理によって、暦月の終わりから約7日後まで修正されることがあります。確定した合計が必要なら、終了からその日数が過ぎた月だけを取得します。

料金と提供範囲

このAPI自体の利用料金については、公式の発表では触れられていません。日本での提供についても触れられていません。

クラウド経由の組織については、次の説明があります。

• Claude Platform on AWS： 両方のエンドポイントを利用できます。認可はAWS IAMで行います。各リクエストの対象は呼び出したリージョンのワークスペースだけなので、組織全体を見るにはリージョンごとに呼び出します。一部の軸は常にnullになります
• Claude Models on Google Cloud（Anthropic管理）： 両方のエンドポイントを利用できます。Google Cloudの認証情報を使い、usageAnalytics.listとcostAnalytics.listのIAM権限が必要です

向いている用途

• 費用の割り当て： ワークスペース、APIキー、モデル、サービスティア、利用者別に費用とトークン量を分ける
• 利用の多い対象の特定： 「今月最も費用を使っているAPIキーはどれか」のような問いに、トークン数、リクエスト数、費用の順位で答える
• 時系列の集計： 日・時間・分単位に分けて、ダッシュボードや財務レポートに使う

一方、リアルタイムの監視には注意が必要です。データ反映には上で述べた遅れがあります。

既存のAPIから移行するときの変更点

Claude ConsoleでUsage and Cost APIを使っている場合、Admin APIキー、期間の指定方法、トークンや費用の項目名などは引き継げます。主に次の点が変わります。

• データの反映： 旧APIは通常5分以内でしたが、新APIは通常4時間以内です
• 応答の形： 時間の区切りごとのリストから、order_byで順位付けされた行のリストになります。空の区切りは返らないため、日次レポートでは利用のない日を自分でゼロで埋めます
• パラメーター名： bucket_widthがtime_bucket_widthに変わり、既定値がなくなります
• limitの意味： 区切りの数ではなく行数を数えます。指定できる値は1,000行まで、既定は20行です。費用のエンドポイントのcost_typeとtoken_typeにはlimitが適用されないため、各ページの行数がlimitを超えることがあります
• 利用者の指定： account_ids[]やservice_account_ids[]はactor_ids[]に、利用者別の集計はgroup_by[]=actorになります
• 存在しないIDの扱い： エラーではなく、何にも一致しない結果になります。綴りの誤りに気付きにくくなる点に注意が必要です

Claude Enterpriseのレポートから移行すると、各区切りの上位100グループに限られず、データのあるすべての組み合わせを取得できます。actorを他の軸と組み合わせた集計も、使用量と費用の両方で可能です。

よくある質問

個人アカウントでも使えますか？

Admin APIは個人アカウントでは利用できません。Claude Consoleで組織を設定する必要があります。Claude Enterpriseの組織は、read:analyticsスコープのキーを使います。

旧Usage and Cost APIはすぐに使えなくなりますか？

レガシー扱いになりましたが、引き続きサポートされます。提供終了の時期は、公式の発表では触れられていません。

費用データは請求額と一致しますか？

一致するとは限りません。amountはクレジット適用前の金額で、Priority Tierの契約料金も含まれません。数値は月の終わりから約7日後まで修正されることがあります。

1年分をまとめて取得できますか？

1回のリクエストでは取得できません。指定できる期間は最大31日なので、複数のリクエストに分けます。開始日は2026年1月1日以降で、かつ過去365日以内に限られます。

利用料金はかかりますか？

このAPI自体の料金については、公式の発表では触れられていません。