> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capriole.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Capriole AI の課金トークンの説明

> キャッシュなし入力、キャッシュ入力、出力から Capriole AI の課金トークンを計算します。再現可能な例と、個人および Team のクォータ境界を示します。

課金トークンは、Capriole AI API 残高から差し引かれる単位です。個人 Premium は、USD 8 のワークスペース メンバーシップの一部として、毎月 500 万を含みます。キャッシュなし入力と出力は 100% で数えます。キャッシュ入力は 10% で数え、次の整数トークンへ切り上げます。

公開 API とコーディング エージェントのトラフィックに適用されます。無制限の Premium Browser Chat はこの API 残高を消費しません。

## 計算式

Capriole は、対応する各プロトコルを入力トークンの合計数に正規化し、選択したプロバイダーが報告する場合はキャッシュ入力数も正規化します。キャッシュ入力は合計入力の部分集合です。

```text theme={null}
uncached_input = input_tokens - cached_input

charged_tokens =
  uncached_input
  + ceil(cached_input × 0.1)
  + output_tokens
```

プロバイダーがキャッシュ入力を報告しない場合、すべての入力トークンは 100% で数えられます。Capriole は、使用量メタデータが報告していない cache hit を推測しません。

| プロトコル                   | 正規化後の入力                                                                | キャッシュ部分集合                             |
| ----------------------- | ---------------------------------------------------------------------- | ------------------------------------- |
| OpenAI Responses        | `input_tokens`                                                         | `input_tokens_details.cached_tokens`  |
| OpenAI Chat Completions | `prompt_tokens`                                                        | `prompt_tokens_details.cached_tokens` |
| Anthropic Messages      | `input_tokens + cache_creation_input_tokens + cache_read_input_tokens` | `cache_read_input_tokens`             |

Anthropic Messages では、cache creation は引き続き 100% の入力です。10% の課金トークン扱いを受けるのは、報告された cache reads だけです。

## 再現可能な 3 つの例

| 例                  |    入力合計 | キャッシュ入力 |  出力 | 計算                          | 課金トークン |
| ------------------ | ------: | ------: | --: | --------------------------- | -----: |
| cache hit なし       |     800 |       0 | 200 | `800 + 0 + 200`             |  1,000 |
| ほとんどキャッシュされたプロンプト  |  10,000 |   8,000 | 500 | `2,000 + ceil(800) + 500`   |  3,300 |
| 大きく報告された cache hit | 228,807 | 228,224 |  90 | `583 + ceil(22,822.4) + 90` | 23,496 |

3 番目のリクエストは、生の入力 + 出力トークンが 228,897 です。プロバイダーが 228,224 入力トークンをキャッシュ済みと報告したため、23,496 課金トークンを差し引きます。

丸めは、記録された各リクエストのキャッシュ部分に対して行われます。そのため、キャッシュ入力トークン 1 個は `ceil(0.1)` のあと 1 トークン課金され、キャッシュ入力トークン 10 個も 1 トークン課金されます。

## 500 万課金トークンで何件のリクエストが入るか見積もる

生のコンテキスト サイズから推測せず、自分の API 使用量の平均課金トークン値を使ってください。

```text theme={null}
estimated_requests = floor(5,000,000 / average_charged_tokens_per_request)
```

| リクエストあたりの平均課金トークン | 500 万課金トークンから得られるリクエスト数 |
| ----------------: | ----------------------: |
|             1,000 |                   5,000 |
|             5,000 |                   1,000 |
|            25,000 |                     200 |
|           100,000 |                      50 |

これらの行は計画用の算術であり、典型的なワークロードの主張ではありません。短い分類呼び出しと長いコーディング エージェントのターンは、桁が違う場合があります。出力の長さ、繰り返されるコンテキスト、プロバイダーが報告する cache hit、ツール結果は、いずれも実測平均を変えます。

## 課金トークンとプロバイダー価格は異なる単位を使う

公式プロバイダーは、入力、キャッシュ入力、キャッシュ書き込み、出力、ツール、または長いコンテキストに別々の価格を公開する場合があります。Capriole の課金トークン残高は、対応する公開 API ルート全体で 1 つの計算式を使う顧客クォータ単位です。

| 単位               | 答えること                             |
| ---------------- | --------------------------------- |
| プロバイダーの入力と出力の価格  | プロバイダーが自身の価格表の下でいくら請求するか          |
| 生の API 使用量トークン   | レスポンスが報告する入力、出力、キャッシュ トークンの数      |
| Capriole の課金トークン | Capriole がアカウントの API 残高からいくら差し引くか |

課金トークンに、プロバイダーが公開する入力または出力レートを掛けないでください。単位は異なる請求システムを表します。

[日付付き API コスト比較](/ja/articles/ai-api-cost-comparison) は、この計算式を固定の 500 万トークン ワークロードに適用し、各サービスの現金コストを比較します。

## 個人と Team の残高境界

| アクセス       |                    含まれる API 残高 |       トップアップの基本価格 | 現在の規則                                                                           |
| ---------- | -----------------------------: | ----------------: | ------------------------------------------------------------------------------- |
| 個人 Premium |     有効な月次クォータ期間ごとに 500 万課金トークン |    500 万あたり USD 8 | 公開 API と個人トップアップには有効な Premium アクセスが必要です。複数パックの購入には、表示されるボリューム割引が最大 15% まで適用されます |
| Team       | 有効な月次クォータ期間ごとに共有 5,000 万課金トークン | 5,000 万あたり USD 80 | USD 70/月 に 5 席が含まれます。owner と admin は 1 から 5 パックまで購入でき、表示されるボリューム割引は最大 10% です    |

含まれるクォータは、対応する個人または Team のトップアップ ウォレットより先に消費されます。購入したトップアップ残高は、月次クォータ期間と有料アクセスの空白をまたいで残ります。消費するには、対象となる有効な有料アクセスが引き続き必要です。Browser Chat は API 会計とは別です。コーディング エージェントは API トラフィックとして数えられ、課金トークンを差し引きます。

毎月 500 万は、完全な USD 8 Premium ワークスペース メンバーシップの一部です。無制限 API プランではなく、独立した API 価格として提示すべきではありません。

トップアップはプログラム利用を伸ばします。Browser Chat の許容量、モデル互換性、対象となる有効な個人または Team アクセスの要件は変わりません。

## API が記録すること

Capriole は、プロトコル正規化済み使用量と課金使用量を別フィールドとして保持します。成功した公開 API リクエストは、次を記録できます。

* 正規化後の入力トークン
* 出力トークン
* 正規化後の入力 + 出力トークン
* プロバイダーが報告したキャッシュ入力トークン
* クォータから差し引かれた課金トークン
* 解決後のモデルとリクエスト ステータス

Capriole ネイティブの `POST /v1/chat` レスポンスは、`usage` 内に `cached_tokens` と `charged_tokens` を公開します。プロトコル互換の Responses、Chat Completions、Messages エンドポイントは上流のレスポンス形状を保持し、Capriole はアカウント使用量向けに対応する課金トークン値を記録します。

## キャッシュ入力が課金を減らしたかを確認する

Capriole AI の [API ページ](https://capriole.ai?view=api) を開き、**Key**、**Model**、**Status** フィルタでリクエストを切り出します。使用量テーブルの次の列を比較してください。

| 列                  | 確認できること                      |
| ------------------ | ---------------------------- |
| **Input tokens**   | キャッシュ入力を分ける前の、プロトコル正規化済み入力   |
| **Cached tokens**  | プロバイダーがキャッシュ済みと報告した入力        |
| **Charged tokens** | キャッシュ入力の計算式を適用したあと差し引かれたクォータ |
| **Total tokens**   | プロトコル正規化済みの入力 + 出力           |

正のキャッシュ トークン値は、互換のプロバイダー使用量メタデータが cache hit を報告したことを確認します。繰り返すすべてのリクエストが同じプロバイダー キャッシュに当たることは証明しません。プロバイダー ルーティング、キャッシュ寿命、リクエスト構造、モデル動作は結果を変える場合があります。

Capriole ネイティブの `POST /v1/chat` では、同じ確認を `usage.cached_tokens` と `usage.charged_tokens` で行えます。他のプロトコル レスポンスは上流スキーマを保持するため、ルートをまたいでリクエストを比較する一貫した場所はアカウント使用量テーブルです。

## よくある質問

### キャッシュ入力は常に 90% のクォータ割引を受けますか？

選択したプロバイダーが、互換の使用量メタデータでキャッシュ入力を報告する場合だけです。キャッシュ メタデータがないことは cache hit として扱われません。

### reasoning トークンは 2 回加算されますか？

いいえ。プロバイダーが報告する出力使用量には、そのルートが使う出力会計がすでに含まれています。Capriole はこの計算式の出力の上に、別の reasoning トークン課金を加算しません。

### Premium では API 使用量は無制限ですか？

いいえ。Premium の Browser Chat は、対応する Premium モデル群で無制限です。API とコーディング エージェントのリクエストは、含まれる課金トークン残高と、利用可能なトップアップ残高を使います。

### コーディングはどこから始めるべきですか？

最小の生リクエストには [API クイックスタート](/ja/quickstart)、プロトコルネイティブの Python と TypeScript クライアントには [OpenAI と Anthropic の SDK ガイド](/ja/guides/openai-anthropic-sdks) を使ってください。まだサブスクライブしていない場合は、アップグレード前に [制限付きの無料 Browser Chat で旗艦モデルを試す](https://capriole.ai) ことができます。

このページの Capriole プラン、クォータ、トップアップ、課金トークンの事実は、第一当事者ドキュメントとして維持されています。

**事実確認日：** 2026-08-11。
