---
title: 使用量とコストAPI
url: https://platform.claude.com/docs/ja/manage-claude/usage-cost-api
description: Usage and Cost Admin APIを使用して、組織のAPI使用量とコストデータにプログラムからアクセスします。
---

<Tip>
  **Admin APIは個人アカウントではご利用いただけません。** チームメイトと共同作業を行い、メンバーを追加するには、Claude Consoleの[Organization](https://platform.claude.com/settings/organization)ページ（`platform.claude.com/settings/organization`）で組織を設定してください。
</Tip>

Usage and Cost Admin APIは、組織の過去のAPI使用量とコストデータへのプログラムによる詳細なアクセスを提供します。このデータは、Claude Consoleの[Usage](https://platform.claude.com/usage)ページ（`platform.claude.com/usage`）および[Cost](https://platform.claude.com/cost)ページ（`platform.claude.com/cost`）で確認できる情報と同様のものです。

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

* **正確な使用量追跡：** レスポンスのトークンカウントのみに頼るのではなく、正確なトークン数と使用パターンを取得できます
* **コストの照合：** 財務・経理チームのために、社内記録とAnthropicの請求を照合できます
* **製品のパフォーマンスと改善：** システムへの変更によって改善されたかどうかを測定しながら製品のパフォーマンスを監視したり、アラートを設定したりできます
* **[レート制限](https://platform.claude.com/docs/ja/api/rate-limits)の最適化：** [プロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching)や特定のプロンプトなどの機能を最適化し、割り当てられた容量を最大限に活用できます
* **高度な分析：** Consoleで利用できるものよりも深いデータ分析を実行できます

<Check>
  **Admin API認証情報が必要です。** これらのエンドポイントはAdmin APIの一部です。[Admin APIキー](https://platform.claude.com/docs/ja/manage-claude/admin-api-keys)、`org:admin`スコープを持つOAuthトークン、またはワークスペースにスコープされていない個人アカウントキーもしくはサービスアカウントキーを使用してアクセスできます。ワークスペースAPIキーは使用できません。詳細については、[認証](https://platform.claude.com/docs/ja/manage-claude/admin-api#authentication)を参照してください。
</Check>

Claude Enterprise組織は、代わりに別のAPIでAnalytics APIキーを使用します。[どのAPIが必要ですか？](https://platform.claude.com/docs/ja/manage-claude/usage-cost-api#which-api-do-you-need)を参照してください。

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

## どのAPIが必要ですか？

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

| 組織                              | API                                                                                                                     | キーの種類                                                                                                                               |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Claude Console（Claude Platform） | このページで説明するUsage and Cost Admin API                                                                                      | Admin APIキー（`sk-ant-admin01-...`）またはその他の[Admin API認証情報](https://platform.claude.com/docs/ja/manage-claude/admin-api#authentication) |
| Claude Enterprise（claude.ai）    | [Claude Enterprise Analytics API](https://platform.claude.com/docs/ja/api/beta/organization/analytics)のコストおよび使用量エンドポイント | Analytics APIキー                                                                                                                     |

Claude Enterpriseの親組織はClaude Consoleに表示されず、Admin APIキーを持たないため、これらの組織にとってはAnalytics APIキーがこのデータにアクセスする唯一の手段です。各キーの種類の作成方法、およびClaude Enterpriseのコストデータがどのプランに適用されるかについては、[Analytics API](https://platform.claude.com/docs/ja/manage-claude/analytics-api)を参照してください。

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

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

<CardGroup cols={3}>
  <Card title="CloudZero" icon="chart" href="https://docs.cloudzero.com/docs/connections-anthropic">
    コストの追跡と予測のためのクラウドインテリジェンスプラットフォーム
  </Card>

  <Card title="Datadog" icon="chart" href="https://docs.datadoghq.com/integrations/anthropic/">
    自動トレースと監視を備えたLLMオブザーバビリティ
  </Card>

  <Card title="Grafana Cloud" icon="chart" href="https://grafana.com/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-anthropic/">
    すぐに使えるダッシュボードとアラートにより、LLMオブザーバビリティを簡単に実現するエージェントレス統合
  </Card>

  <Card title="Harness" icon="chart" href="https://developer.harness.io/docs/cloud-cost-management/provider-integrations/ai-providers/anthropic/">
    クラウドとAIのコスト管理のためのFinOpsプラットフォーム
  </Card>

  <Card title="Honeycomb" icon="polygon" href="https://docs.honeycomb.io/integrations/anthropic-usage-monitoring/">
    OpenTelemetryによる高度なクエリと可視化
  </Card>

  <Card title="Tempo" icon="chart" href="https://help.tempo.io/workforceintelligence/latest/connect-to-anthropic">
    Jiraの作業項目への使用量とコストの帰属
  </Card>

  <Card title="Vantage" icon="chart" href="https://docs.vantage.sh/connecting_anthropic">
    LLMのコストと使用量のオブザーバビリティのためのFinOpsプラットフォーム
  </Card>
</CardGroup>

## クイックスタート

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

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

<Tip>
  **統合機能にはUser-Agentヘッダーを設定してください**

  統合機能を構築している場合は、Anthropicが使用パターンを把握できるようにUser-Agentヘッダーを設定してください。

  ```text wrap
  User-Agent: YourApp/1.0.0 (https://yourapp.com)
  ```
</Tip>

## Usage API

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

### 主要な概念

* **タイムバケット：** 固定間隔（`1m`、`1h`、または`1d`）で使用量データを集計します
* **トークン追跡：** キャッシュされていない入力、キャッシュされた入力、キャッシュ作成、および出力トークンを測定します
* **フィルタリングとグループ化：** APIキー、ワークスペース、モデル、サービスティア、コンテキストウィンドウ、[データレジデンシー](https://platform.claude.com/docs/ja/manage-claude/data-residency)、またはスピードでフィルタリングし、これらのディメンションで結果をグループ化します
* **サーバーツール使用：** ウェブ検索などのサーバーサイドツールの使用量を追跡します

パラメータの詳細とレスポンススキーマの全容については、[Usage APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization/usage_report/retrieve_messages)を参照してください。

### 基本的な例

#### モデル別の日次使用量

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

#### フィルタリング付きの時間別使用量

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

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

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

<Tip>
  組織のAPIキーIDを取得するには、[List API Keys](https://platform.claude.com/docs/ja/api/organization/api_keys/list)エンドポイントを使用します。

  組織のワークスペースIDを取得するには、[List Workspaces](https://platform.claude.com/docs/ja/api/organization/workspaces/list)エンドポイントを使用するか、Claude Consoleで組織のワークスペースIDを確認してください。
</Tip>

#### データレジデンシー

`inference_geo`ディメンションで使用量をグループ化およびフィルタリングすることで、[データレジデンシー制御](https://platform.claude.com/docs/ja/manage-claude/data-residency)を追跡します。これは、組織全体の地理的ルーティングを検証するのに役立ちます。

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

特定のgeoでフィルタリングすることもできます。有効な値は`global`、`us`、および`not_available`です。

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

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

#### Fastモード

`speed`ディメンションでグループ化およびフィルタリングすることで、[fastモード](https://platform.claude.com/docs/ja/build-with-claude/fast-mode)の使用量を追跡します。これは、標準モードとfastモードの使用量を監視するのに役立ちます。

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

特定のスピードでフィルタリングすることもできます。有効な値は`standard`と`fast`です。

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

### 時間粒度の制限

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

## Cost API

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

### 主要な概念

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

パラメータの詳細とレスポンススキーマの全容については、[Cost APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization/cost_report/retrieve)を参照してください。

<Warning>
  Priority Tierのコストは異なる課金モデルを使用しており、コストエンドポイントには含まれません。代わりに、使用量エンドポイントを通じてPriority Tierの使用量を追跡してください。
</Warning>

### 基本的な例

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

## ページネーション

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

1. 最初のリクエストを行います。
2. `has_more`が`true`の場合、次のリクエストで`next_page`の値を使用します。
3. `has_more`が`false`になるまで続けます。

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "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..." \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

## 一般的なユースケース

[Claude Cookbook](https://platform.claude.com/cookbook)で詳細な実装を確認してください。

* **日次使用量レポート：** トークン消費の傾向を追跡します
* **コスト配分：** チャージバックのためにワークスペースごとに費用を割り当てます
* **キャッシュ効率：** プロンプトキャッシングを測定し最適化します
* **予算監視：** 支出しきい値のアラートを設定します
* **CSVエクスポート：** 財務チーム向けのレポートを生成します

## よくある質問

### データの鮮度はどの程度ですか？

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

### 推奨されるポーリング頻度はどのくらいですか？

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

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

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

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

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

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

Claude Consoleのplayground（およびそれ以前のレガシーWorkbench）からのAPI使用量はAPIキーに関連付けられていないため、そのディメンションでグループ化した場合でも`api_key_id`は`null`になります。

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

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

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

[Claude Code Analytics API](https://platform.claude.com/docs/ja/manage-claude/claude-code-analytics-api)を使用してください。これは、多数のAPIキーでコストを分割する際のパフォーマンス上の制限なしに、ユーザーごとの推定コストと生産性メトリクスを提供します。多数のキーを使用する一般的なAPI使用量については、[Usage API](https://platform.claude.com/docs/ja/manage-claude/usage-cost-api#usage-api)を使用して、コストの代替指標としてトークン消費量を追跡してください。

## 関連項目

Usage APIとCost APIを使用して、ユーザーにより良い体験を提供し、コストを管理し、レート制限を維持してください。その他の機能の詳細については、以下を参照してください。

* [Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)
* [Admin APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization)
* [Analytics API](https://platform.claude.com/docs/ja/manage-claude/analytics-api) - 組織に必要な分析APIとキーの種類
* [料金](https://platform.claude.com/docs/ja/about-claude/pricing)
* [プロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching) - キャッシングでコストを最適化
* [バッチ処理](https://platform.claude.com/docs/ja/build-with-claude/batch-processing) - バッチリクエストで50%割引
* [レート制限](https://platform.claude.com/docs/ja/api/rate-limits) - 使用量ティアを理解する
* [Rate Limits API](https://platform.claude.com/docs/ja/manage-claude/rate-limits-api) - 設定されたレート制限を読み取る
* [データレジデンシー](https://platform.claude.com/docs/ja/manage-claude/data-residency) - 推論の地理的場所を制御する