> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/org/credits.md).

# Credits 課金制度

MaiAgent プラットフォームの Credits ポイント課金制度 — ひとつの利用枠ですべての AI 機能をカバー。

{% hint style="success" %}
✨ **MaiAgent は Credits ポイント制で課金します** — ひとつの利用枠で対話・音声・画像生成・ドキュメント解析などすべての AI 機能を同時にカバーし、モデルは等級ごとに課金され、利用量は透明で追跡可能です。
{% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ddb6a71dfed0998f8b18369fa94f0875e72b8442%2Fcredit-illustration-1-hero.png?alt=media" alt=""><figcaption><p>Credits 課金制度 — ひとつの利用枠ですべての AI 機能をカバー</p></figcaption></figure>

## Credits 制の 3 つの特長 <a href="#credits-highlights" id="credits-highlights"></a>

### 1. ひとつの利用枠ですべての AI 機能をカバー <a href="#one-quota-for-everything" id="one-quota-for-everything"></a>

**すべての機能がデフォルトで利用可能で、各機能がそれぞれ独立した Credits 料率を持ちます** — ひとつの利用枠ですべての AI サービスを同時にカバーするため、個別に調達したり複数のプラットフォームと契約したりする必要がなく、**課金がより直感的になり、予算がよりコントロールしやすくなります**。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-c4dfe904ceee4ce7bfcd6656895e75aee384496d%2Fcredit-illustration-2-all-in-one.png?alt=media" alt=""><figcaption><p>ひとつの Credits 利用枠で、対話・音声・画像生成・ドキュメント解析・Web 検索・ツール呼び出しを同時にサポート</p></figcaption></figure>

### 2. モデルは等級ごとに課金、予算のコントロール権がお客様の手に <a href="#multi-model-budget-control" id="multi-model-budget-control"></a>

AI モデルによってコストの差は最大で **数十倍** に達することがあり、Credits 制ではこの差が料金にそのまま反映されます。

* 一般的なカスタマーサポートの FAQ → **Claude 4.5 Haiku** でコストを節約
* 複雑な分析、深い調査 → **Claude 4.6 Opus** で最高品質を実現
* 複数の AI アシスタントがそれぞれ異なるモデルを使用し、等級ごとの料率で Credits を差し引きます。予算の配分はお客様が決定できます

### 3. 透明で追跡可能、財務照合が簡単に <a href="#transparent-tracking" id="transparent-tracking"></a>

すべての Credits 消費は **使用したモデル、機能タイプ、AI アシスタント** に対応しており、管理パネルでリアルタイムに照会したり、任意の軸で絞り込んだり、CSV にエクスポートして社内レポートを作成したりできます。**「お金がどこに使われたかわからない」という悩みはもうありません。**

***

## Credits とは？ <a href="#what-is-credits" id="what-is-credits"></a>

Credits は MaiAgent プラットフォームの**共通課金単位**です。AI 対話、画像生成、音声処理、ドキュメント解析などの操作のたびに、使用したモデルと機能に応じて対応する Credits を消費します。

### 基本原則 <a href="#core-principles" id="core-principles"></a>

* **モデルが異なれば、料率も異なる**：軽量なモデルを使えば費用は少なく、フラッグシップモデルを使えば比例料金で課金されます — 各タスクにいくらかける価値があるかをお客様が決定します
* **すべての機能を統一課金**：テキスト、画像、音声、ドキュメント解析、Web 検索などはすべて Credits で統一して計測されます
* **透明で追跡可能**：管理パネルで Credits 残高と各利用明細をリアルタイムに確認でき、CSV エクスポートに対応します
* **先に入ったものから先に差し引き**：FIFO の順序で自動的に差し引かれ、**有効期限が早い Credits から優先的に使用される**ため、期限切れによる無駄を防ぎます

***

## 主要モデルの Credits 料率 <a href="#model-rates" id="model-rates"></a>

各ブランドの代表的なモデルの料率です。**Input と Output は別々に課金されます**（100 万 tokens あたり）。

| モデル                   | Input Credits / 1M tokens | Output Credits / 1M tokens | 適用シーン                     |
| --------------------- | ------------------------- | -------------------------- | ------------------------- |
| **Claude 4.6 Opus**   | 99,000                    | 495,000                    | 深い調査、高品質な創作、複雑な推論         |
| **Claude 4.6 Sonnet** | 59,400                    | 297,000                    | 複雑な分析、コンテンツ生成、専門的な質疑応答    |
| **Claude 4.5 Haiku**  | 19,800                    | 99,000                     | 一般的なカスタマーサポート、FAQ、簡単な質疑応答 |
| **GPT-5**             | 24,750                    | 198,000                    | 高度な分析、長文処理                |
| **GPT-5-mini**        | 4,950                     | 39,600                     | 一般的な質疑応答、簡単なタスク           |
| **Gemini 3.1 Pro**    | 39,600                    | 237,600                    | 長いコンテキスト、複雑な分析            |
| **Gemini 3 Flash**    | 9,900                     | 59,400                     | 一般的な質疑応答、マルチモーダル          |

{% hint style="info" %}
**実際の利用量の例**：最もよく使われる **Claude 4.5 Haiku** を例にすると、約 500 文字のカスタマーサポート対話 1 回でおよそ **25〜50 Credits** を消費します。1,000,000 Credits の追加購入で数万回のカスタマーサポート対話をまかなえます — しかもこの利用枠は音声・画像生成・ドキュメント解析の処理にも同時に使えます。
{% endhint %}

プラットフォームは画像生成、音声テキスト変換、テキスト音声変換、ドキュメント解析、Web 検索などの機能にも対応しており、**すべて Credits で統一して課金され、別途追加購入は不要です**。完全な料率表は <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**課金方式**</mark> でご確認いただけます。

***

## 各プランで利用可能な tokens の目安 <a href="#plan-token-reference" id="plan-token-reference"></a>

使用するモデルによって、同じ Credits で処理できる token 量は次のように異なります。

| プラン        | 月間 Credits | Claude 4.5 Haiku 処理目安 | Claude 4.6 Sonnet 処理目安 | Claude 4.6 Opus 処理目安 |
| ---------- | ---------- | --------------------- | ---------------------- | -------------------- |
| スタンダード版    | 500,000    | \~1,148 万 tokens      | \~383 万 tokens         | \~77 万 tokens        |
| プロフェッショナル版 | 5,000,000  | \~11,478 万 tokens     | \~3,826 万 tokens       | \~765 万 tokens       |
| エンタープライズ版  | 10,000,000 | \~22,957 万 tokens     | \~7,652 万 tokens       | \~1,530 万 tokens     |

***

## Credits 追加購入プラン <a href="#topup-plans" id="topup-plans"></a>

| Credits   | Claude 4.5 Haiku 処理目安 |
| --------- | --------------------- |
| 50,000    | \~115 万 tokens        |
| 500,000   | \~1,148 万 tokens      |
| 1,000,000 | \~2,296 万 tokens      |
| 2,500,000 | \~5,739 万 tokens      |

{% hint style="info" %}
**有効期限のルール**\
• **月額プランの配分** Credits は当月末に期限切れになります\
• **追加購入** の Credits は購入日から **12 か月以内** 有効で、未使用の Credits は期限切れ後に失効します
{% endhint %}

***

## プラン配分と追加購入枠の関係 <a href="#plan-vs-topup" id="plan-vs-topup"></a>

サブスクリプションプランの「**月間配分**」と「**追加購入 Credits**」は、独立しつつも互いを補完する 2 つの利用枠です。システムが差し引きの順序を自動で処理するため、お客様が手動で配分する必要はありません。

### 両者の比較 <a href="#plan-vs-topup-comparison" id="plan-vs-topup-comparison"></a>

| 項目          | プラン配分（月間）                       | 追加購入 Credits             |
| ----------- | ------------------------------- | ------------------------ |
| **由来**      | サブスクリプションプランから自動付与              | お客様がいつでも購入               |
| **付与タイミング** | 毎月月初                            | 購入後すぐに有効                 |
| **有効期間**    | **当月末に期限切れ**、使い切れなかった分は繰り越されません | 購入日から **12 か月以内** 有効     |
| **適用シーン**   | 平常時の標準的な利用量                     | 月間配分が不足したときの補充 / 突発的な利用量 |

### 差し引きの順序：期限が早いものから先に差し引き（FIFO） <a href="#fifo-deduction" id="fifo-deduction"></a>

システムは **FIFO（先入れ先出し）** のロジックを採用し、「**有効期限の早い順**」で差し引きの順序を決定します。

```
平常時の利用 → まず当月の「プラン配分」を差し引き（月末に期限切れ）
        → 配分を使い切ったら → 自動的に「追加購入 Credits」を差し引き（購入日の早い順）
        → 月末にリセット → 翌月の配分が再度付与
```

この設計の目的：**お客様が追加購入した Credits が無駄に差し引かれ、月間配分が期限切れで無駄になるのを防ぐ** ことです。

{% hint style="success" %}
**例**：お客様がエンタープライズ版（月間 10,000,000 Credits 配分）で、月の途中に 1,000,000 Credits を追加購入したとします。

* システムはまず当月の残りの月間配分を使い切ります（月末に期限切れ）
* 月間配分を使い切ってから、追加購入した 1,000,000 Credits を使用します（12 か月以内のいつでも使用できるよう保持）
  {% endhint %}

### なぜ 2 種類に分けるのか？ <a href="#why-two-types" id="why-two-types"></a>

* **サブスクリプションプラン配分** = 平常時の安定した予算、毎月固定
* **追加購入 Credits** = 柔軟な予備、業務需要が突発的に増えたときにいつでも補充
* 両者を組み合わせることで、**予算をコントロールしつつ、変動にも対応できます**

***

## AI Gateway 自社運用モデルのトラフィック料金 <a href="#ai-gateway-traffic-fee" id="ai-gateway-traffic-fee"></a>

組織が独自に用意した認証情報、または自社で構築した AI Gateway モデルを使用する場合、MaiAgent はプラットフォームの LLM token 料率では課金せず、その呼び出しの総 token 数に基づいてトラフィック料金を請求します。総 token 数には、入力、出力、プロンプトキャッシュへの書き込み、プロンプトキャッシュからの読み取りが含まれます。実際の割合は組織設定によって異なります。

{% hint style="info" %}
トラフィック料金は「総 token 数 × 組織のトラフィック料率」で計算され、その結果が Credits から差し引かれます。MaiAgent が提供するホスト型モデルを使用する場合は、引き続き各モデルの既定の Input／Output 料率で課金され、本セクションは適用されません。
{% endhint %}

### 利用シーン <a href="#traffic-fee-scenario" id="traffic-fee-scenario"></a>

たとえば、情報システム部門が社内運用のモデルを AI Gateway に接続し、経理担当者が月末にこの種の呼び出し費用を確認するとします。担当者はまず「課金方式」で組織に適用されるトラフィック料率を確認し、次に「消費記録」でプラットフォーム費用を絞り込みます。画面には AI Gateway のトラフィック料金が表示されるため、自社運用モデルのトラフィックとホスト型モデルの費用を分けて照合できます。

### トラフィック料率と消費量の確認 <a href="#view-traffic-fee" id="view-traffic-fee"></a>

1. <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**課金方式**</mark> の順に進みます。
2. 「プラットフォーム費用」カテゴリで <mark style="color:blue;">**AI Gateway トラフィック料金**</mark> を見つけ、「総 token 数 × 割合」という料率の説明を確認します。
3. <mark style="color:blue;">**消費記録**</mark> に切り替え、「プラットフォーム費用」で実際の差し引きを絞り込みます。
4. AI Gateway トラフィック料金の明細にカーソルを合わせると、入力、出力、キャッシュ書き込み、キャッシュ読み取り、課金割合を確認できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-589731f9acdea9f28a8b1c8605e68e6b33f18548%2Fcredits-ai-gateway-pricing.png?alt=media" alt="Credits 課金方式タブ"><figcaption><p>「課金方式」で各サービスの Credits 料率を確認できます。</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-24638d9ed0a64102b9d9097ba106fef27c141f93%2Fcredits-ai-gateway-consumption.png?alt=media" alt="Credits 消費記録タブ"><figcaption><p>「消費記録」でタイプ、サービスカテゴリ、日付、キーワードを指定し、実際の差し引きを絞り込めます。</p></figcaption></figure>

{% hint style="warning" %}
組織が自社運用（BYOK／自社ホスト）の AI Gateway モデルを実際に使用した後に限り、消費記録にトラフィック料金の明細が表示されます。課金方式には現在の料率が表示されますが、過去の明細には取引発生時点の課金情報が保持されます。
{% endhint %}

***

## Credits 管理パネル <a href="#management-panel" id="management-panel"></a>

<mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> で管理画面をご利用いただけます。次の 5 つのタブで構成されています。

### 概要 <a href="#overview-tab" id="overview-tab"></a>

* Credits の総残高と間もなく期限切れになる利用枠をリアルタイムに確認
* 月次の利用量トレンドグラフ
* 間もなく期限切れになる Credits のお知らせ
* 残高不足アラートの設定（アプリ内通知 + Email。詳しくは [残高不足アラート](#low-balance-alert) をご覧ください）

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-3f607a177e928d881df79b615c86203016151fb9%2Fcredit-1-overview.png?alt=media" alt=""><figcaption><p>概要タブ：リアルタイムの Credits 残高と期限切れのお知らせ</p></figcaption></figure>

### 入金記録 <a href="#deposits-tab" id="deposits-tab"></a>

* 各 Credits の由来を表示：プラン付与、追加購入、贈呈など
* 有効期間を表示（月間配分は月末に期限切れ、追加購入は購入日から 12 か月）
* **FIFO で差し引き**（期限が早いものから先に差し引き）、各利用枠の残高を完全に表示
* **CSV エクスポート** に対応し、財務記帳や年次棚卸しに便利

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-841869bbc95eef21c7f52365b382ceeb69cce267%2Fcredit-2-deposits.png?alt=media" alt=""><figcaption><p>入金記録タブ：Credits の由来、有効期間、残高を完全に表示</p></figcaption></figure>

### 消費記録 <a href="#consumption-tab" id="consumption-tab"></a>

* 日付、タイプ、AI アシスタントなど複数の軸で利用明細を絞り込み
* 各消費について、使用したモデル、消費した Credits、対応するイベントを表示
* **CSV エクスポート** に対応し、保管や外部分析が可能（社内の財務照合の心強い味方）

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9265ca5f54d3d1ca372e22bb884fccbd26408e54%2Fcredit-3-consumption.png?alt=media" alt=""><figcaption><p>消費記録タブ：各利用明細がモデル・AI アシスタント・イベントに対応</p></figcaption></figure>

### 課金方式 <a href="#pricing-tab" id="pricing-tab"></a>

* すべてのモデルと機能の料率を完全に一覧表示
* LLM 対話、音声、ナレッジベース、クローラー、ツール、AI アシスタント演算、Avatar など、すべての課金カテゴリをカバー

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-081859f5a3b6da7807f239ffd940f0ef69ca22f8%2Fcredit-4-pricing.png?alt=media" alt=""><figcaption><p>課金方式タブ：すべてのモデルと機能の完全な料率表</p></figcaption></figure>

#### 対話添付ファイルと派生ファイルのストレージ料金を確認する <a href="#attachment-and-derived-storage" id="attachment-and-derived-storage"></a>

対話中にアップロードしたファイルは「対話添付ファイルストレージ」を使用します。システムがファイルを解析する際に生成される形式変換、再解析、音声文字起こしのコピーは「派生ファイルストレージ」を使用します。どちらも MB／月単位で課金され、実際の使用量に応じて Credits が日単位で差し引かれます。元のファイルは該当するストレージ項目で課金され、派生ファイルとして重複して課金されることはありません。

{% hint style="info" %}
対話添付ファイルの保持日数はシステム設定に基づき、現在は「対話添付ファイルストレージ」の説明で確認できます。対話に新しいメッセージが届くと、保持期間のカウントダウンが再開されます。保持期間が終了すると、添付ファイルとそれから生成された処理用コピーは自動的に削除され、課金も停止します。削除後は復元できないため、長期保存が必要なファイルは期限前にダウンロードしてください。
{% endhint %}

1. <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> の順に進みます。
2. <mark style="color:blue;">**課金方式**</mark> に切り替えます。
3. <mark style="color:blue;">**ナレッジベースとベクトル検索システム**</mark> を展開します。
4. <mark style="color:blue;">**対話添付ファイルストレージ**</mark> と <mark style="color:blue;">**派生ファイルストレージ**</mark> の単位あたりの Credits と課金単位を確認します。情報アイコンにカーソルを合わせると、保持期間と課金の説明を確認できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-cdaf245bd3a3c0393c93c541287bd6f7b14f5f02%2Fcredits-attachment-storage-pricing.png?alt=media" alt="Credits の課金方式にある対話添付ファイルストレージと派生ファイルストレージの項目"><figcaption><p>「ナレッジベースとベクトル検索システム」を展開し、2 種類のファイルストレージの料率を確認します。</p></figcaption></figure>

**利用シーン**

MaiAgent 社のカスタマーサポート責任者は、訪問者に対話中に問題のスクリーンショットを定期的にアップロードしてもらっています。月末の照合作業では、Credits の「課金方式」を開いて「ナレッジベースとベクトル検索システム」を展開し、対話添付ファイルと解析用コピーにそれぞれどの料率が適用されるかを確認します。添付ファイルの保持に関する説明を確認した後、保存が必要なスクリーンショットを期限前にダウンロードします。使用されなくなった添付ファイルは保持期間の終了後に自動的に削除され、それ以降ストレージ料金は発生しません。

### 利用枠の配分 <a href="#quota-tab" id="quota-tab"></a>

* 管理者は各メンバーに個人ごとの Credits 消費上限と有効期限を設定できます
* 利用枠の配付、編集、停止、および「利用枠が必要」スイッチによる制御に対応
* メンバーの検索・絞り込み、ステータス（有効 / 期限切れ / 未配分）による絞り込みが可能

詳しくは [メンバー Credits 利用枠管理](/maiagent-user-guide/ja/org/credits/member-credit-quota.md) をご覧ください。

***

## 残高不足アラート <a href="#low-balance-alert" id="low-balance-alert"></a>

組織の Credits 残高が設定したしきい値を下回ると、システムが**自動的にアラートを送信**するため、早めに追加購入してサービスの中断を回避できます。アラートは**アプリ内通知**で送信され、有料プランでは **Email も自動送信**されるため、管理画面にログインしなくてもすぐに確認できます。

{% hint style="info" %}
アプリ内通知はすべてのプランで利用できます。**Email 通知は有料プランのみ**利用できます。AWS Marketplace 経由で課金される組織には、このアラートは適用されません。アラートの設定と確認には Credits ページへのアクセス権限が必要です。
{% endhint %}

### 通知チャネル <a href="#alert-channels" id="alert-channels"></a>

| チャネル         | 説明                                         |
| ------------ | ------------------------------------------ |
| **アプリ内通知**   | 残高がしきい値を下回ると、管理画面にお知らせを作成します               |
| **Email 通知** | 有料プランでは、所有者ロールのメンバーとカスタム受信者にもアラートメールを送信します |

2 つのチャネルは同じ**有効化スイッチ**と**アラートしきい値**を共有します。アラートを無効にすると、アプリ内通知と Email の両方が停止します。

### Email の受信者 <a href="#alert-recipients" id="alert-recipients"></a>

* **所有者ロールのすべてのメンバー**：アラートを有効にすると自動的に追加され、必ず送信されます
* **カスタム受信者**：組織は追加の送信先として最大 **5 件**の Email アドレスを入力できます
* 両者が重複する場合、システムが**自動的に重複を除外**し、同じ Email アドレスには 1 通だけ送信します

### 設定方法 <a href="#configure-alert" id="configure-alert"></a>

1. <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**概要**</mark> の順に進みます
2. <mark style="color:blue;">**残高アラート**</mark> カードを見つけ、<mark style="color:blue;">**設定**</mark> をクリックします
3. <mark style="color:blue;">**残高アラートを有効にする**</mark> をオンにし、**アラートしきい値**を入力します
4. <mark style="color:blue;">**通知受信者**</mark> フィールドに、Email を追加で受信するアドレスを入力します（最大 5 件。カンマ区切りの複数の Email を貼り付けると自動的に分割されます）
5. 保存すると設定は完了です

### トリガー条件 <a href="#alert-trigger" id="alert-trigger"></a>

* **残高が設定したアラートしきい値を下回る**と自動的にトリガーされ、アプリ内通知と Email が同時に送信されます
* 重複した通知を避けるため、同じウォレットへの送信は **24 時間に最大 1 回**です
* アラートメールはブランド化された HTML メールで、現在の**残高**、**しきい値**、「Credit 利用詳細を確認」ボタンが含まれます。追加購入が必要な場合は <sales@maiagent.ai> までお問い合わせください

***

## Prompt Cache のキャッシュ利用量 <a href="#prompt-cache-usage" id="prompt-cache-usage"></a>

### Prompt Cache とは？なぜコストを削減できるのか <a href="#what-is-prompt-cache" id="what-is-prompt-cache"></a>

AI アシスタントが応答するたびに、実際には**対話全体のコンテキスト情報**をモデルへ再送する必要があります。これには、ロール指示（System Prompt）、ナレッジベースの内容、以前の対話内容が含まれます。同じアシスタントで繰り返される対話では、これらの内容が**非常に多く重複**します。ロール指示は毎回同じで、ナレッジベースの抜粋も同じになることがよくあります。

**Prompt Cache（プロンプトキャッシュ）は、このような重複に対するコスト最適化です。モデルがキャッシュ可能な内容を処理する際、まず内容をキャッシュに書き込む**ことがあります。その後のリクエストが、有効で内容も同じキャッシュにヒットすると、**キャッシュから読み取る**ことができます。キャッシュの作成と読み取りはそれぞれの料率で課金され、通常、キャッシュ読み取りの単価は一般的な入力より低く設定されています。実際に Credits を節約できるかどうかは、作成コスト、その後のヒット回数、使用するモデルの料率によって異なります。

Prompt Cache が有効な対話では、会計上、次の課金項目が表示される場合があります（「AI テキスト生成・理解モデル」課金カテゴリに属します）。

| 課金項目               | 説明                                                        |
| ------------------ | --------------------------------------------------------- |
| **LLM Cache 作成**   | 入力内容をキャッシュに書き込む際に消費した Token 数で、そのモデルのキャッシュ作成料率に基づいて課金されます |
| **LLM Cache 読み取り** | キャッシュから読み取った入力 Token 数で、そのモデルのキャッシュ読み取り料率に基づいて課金されます      |

{% hint style="info" %}
Prompt Cache を使用するかどうかは、**モデルとプラットフォームの設定**によって自動的に決まるため、手動操作は必要ありません。会計明細には、そのリクエストで実際に発生し、Token 数が 0 より大きいキャッシュ項目のみが表示されます。そのため、「LLM Cache 作成」または「LLM Cache 読み取り」の一方だけが表示される場合も、どちらも表示されない場合もあります。
{% endhint %}

### 利用シーン <a href="#cache-scenario" id="cache-scenario"></a>

組織管理者が、AI アシスタントによって最近キャッシュ経由でコストが削減されたかを確認するには、まず <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**利用統計**</mark> で <mark style="color:blue;">**キャッシュ節約**</mark> を確認します。個別のリクエストを調べるには、<mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**消費記録**</mark> でキャッシュ項目のある対話消費を展開し、作成または読み取りの数量と Credits を確認します。

### 最も節約効果が高いケース <a href="#cache-best-scenarios" id="cache-best-scenarios"></a>

キャッシュによって節約されるのは「重複入力」のコストです。そのため、**重複する内容が多く、繰り返し回数が多いほど、効果も高くなります**。

* **ロール指示（System Prompt）が長いアシスタント**：たとえば、カスタマーサポートアシスタントに対応ルールや製品説明一式が含まれている場合、その後のリクエストが同じキャッシュにヒットすると、より多くの内容に読み取り料率を適用できます
* **利用頻度の高いアシスタント**：キャッシュの有効期間中に、その後のリクエストが同じ内容にヒットする回数が多いほど、キャッシュ作成コストを相殺できる可能性が高くなります
* **複数ターンの長い対話**：モデルが以前の対話内容を再利用できる場合、その後のターンでキャッシュ読み取りの利用量が増えることがあります

### キャッシュ利用量を確認できる場所 <a href="#where-to-view-cache-usage" id="where-to-view-cache-usage"></a>

プラットフォームでは、**個別の会計明細**、**組織の集計統計**、**個々の対話の Token 詳細**という 3 段階で確認できます。

#### 1. Credits → 消費記録と課金方式 <a href="#cache-in-credits" id="cache-in-credits"></a>

個別の照合や、各キャッシュ課金の確認に適しています。

1. <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**消費記録**</mark> の順に進みます
2. キャッシュを使用した対話消費（chat.message）を見つけ、左側の展開矢印をクリックします。明細には、そのリクエストの実際の利用量に応じて「LLM Cache 作成」または「LLM Cache 読み取り」が表示され、消費した Credits、数量、対応するモデルも確認できます
3. <mark style="color:blue;">**課金方式**</mark> タブに切り替えると、各モデルのキャッシュ項目の料率（1,000 Token ごとの課金）を確認できます

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-42d20a806c837c95b5564775545c822794d788ef%2Fcache-01-consumption-records.png?alt=media" alt="消費記録のキャッシュ課金項目"><figcaption><p>消費記録：個別の対話消費を展開し、そのリクエストで実際に発生したキャッシュ課金項目を確認します</p></figcaption></figure>

#### 2. 利用統計 → 課金カテゴリタブ <a href="#cache-in-usage-stats" id="cache-in-usage-stats"></a>

組織全体のキャッシュ消費の割合と節約額を確認するのに適しています。

1. <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**利用統計**</mark> の順に進みます
2. 指標のドロップダウンを <mark style="color:blue;">**Credits**</mark> に切り替えます。切り替えた後にのみ <mark style="color:blue;">**課金カテゴリ**</mark> タブが表示されます
3. <mark style="color:blue;">**利用概要**</mark> セクションでは、選択期間の純節約額が 0 より大きい場合、<mark style="color:blue;">**キャッシュ節約**</mark> に節約された Credits の数値が表示されます
4. <mark style="color:blue;">**課金カテゴリ**</mark> タブに切り替えると、円グラフ、ランキング棒グラフ、明細表で各カテゴリの Credit 消費を確認できます。対応する利用量がある場合、「AI テキスト生成・理解モデル」カテゴリにキャッシュ作成または読み取り項目が表示されます

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0e4cb43b0bda7d8a1a165c3e4eb8323cf15de696%2Fcache-02-savings-card.png?alt=media" alt="利用概要のキャッシュ節約数値"><figcaption><p>利用概要：純節約額が 0 より大きい場合に「キャッシュ節約」が表示されます</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-15e401a076373ed369f3f0ad4409aa373f80784c%2Fusage-stats-credit-categories.png?alt=media" alt="利用統計「課金カテゴリ」タブ：LLM Cache 作成／読み取りの 2 つの課金項目"><figcaption><p>利用統計「課金カテゴリ」タブ：「AI テキスト生成・理解モデル」カテゴリにある LLM Cache 作成／読み取り</p></figcaption></figure>

{% hint style="warning" %}
「課金カテゴリ」タブは**指標を Credits に切り替えた場合のみ表示**され、Credit 課金モデルの組織にのみ適用されます。このタブが見つからない場合は、まず指標のドロップダウンの選択内容をご確認ください。
{% endhint %}

#### 3. AgentOps → 対話テキスト統計 <a href="#cache-in-agentops" id="cache-in-agentops"></a>

**個々の対話**で実際にキャッシュへヒットした状況を分析するのに適しています。

1. <mark style="color:blue;">**AgentOps**</mark> → <mark style="color:blue;">**AI アシスタント監視**</mark> の順に進みます
2. 任意の対話記録の詳細を開き、<mark style="color:blue;">**対話テキスト統計**</mark> セクションを見つけます
3. そのメッセージにキャッシュ利用量がある場合、実際に発生した項目に応じて「LLM Cache 作成」または「LLM Cache 読み取り」の Token 数が表示されます。対応する利用量がない項目は表示されません

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0dec37ee809f2089857bee16844f8d08b641ae89%2Fcache-03-agentops-text-stats.png?alt=media" alt="AgentOpsの会話履歴詳細にある会話テキスト統計"><figcaption><p>会話履歴の詳細：この会話では7,399 LLM Cache読み取りTokenが発生しました。キャッシュ作成の使用量はないため、作成項目は表示されません。</p></figcaption></figure>

### よくあるご質問 <a href="#cache-faq" id="cache-faq"></a>

#### Q：「LLM Cache作成」が請求に含まれているのはなぜですか？ <a href="#cache-faq-extra-charge" id="cache-faq-extra-charge"></a>

「LLM Cache作成」は、そのリクエストの内容がキャッシュに書き込まれ、該当モデルのキャッシュ作成料金に基づいて個別に課金されたことを示します。会話全体の最初のターンにだけ発生するとは限らず、キャッシュの有効期限が切れた場合や、キャッシュ可能な内容が変更された場合には再作成されることがあります。後続のリクエストがキャッシュにヒットすると、「LLM Cache読み取り」の料金に基づいて課金されます。選択した期間の純削減額は、<mark style="color:blue;">**使用量統計**</mark>に表示される<mark style="color:blue;">**キャッシュによる削減**</mark>で確認してください。作成コストが読み取りによる削減額を上回る場合、この数値は表示されません。

#### Q：キャッシュによってどれくらい節約できたかを確認するにはどうすればよいですか？ <a href="#cache-faq-savings" id="cache-faq-savings"></a>

<mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**使用量統計**</mark>に移動し、<mark style="color:blue;">**使用量の概要**</mark>セクションで<mark style="color:blue;">**キャッシュによる削減**</mark>を確認してください。選択した期間の純削減額が0より大きい場合、節約できたCredits数が表示されます。0、負の値、または表示精度を下回る場合は表示されません。

#### Q：Prompt Cacheを自分で有効にする必要がありますか？ <a href="#cache-faq-enable" id="cache-faq-enable"></a>

**必要ありません**。キャッシュを使用するかどうかは、モデルの機能とプラットフォーム設定に基づいて自動的に決定されます。追加の操作や設定は不要です。

#### Q：一部の会話にキャッシュ項目が表示されないのはなぜですか？ <a href="#cache-faq-missing" id="cache-faq-missing"></a>

キャッシュ項目は、モデルから該当する使用量が報告された場合にのみ表示されます。そのリクエストでキャッシュの作成もヒットも発生しなかった場合、明細に該当項目は表示されません。AIアシスタントの通常の応答には影響しません。

***

## よくあるご質問 <a href="#faq" id="faq"></a>

### Q：異なるモデルを組み合わせて使用できますか？ <a href="#faq-mixed-models" id="faq-mixed-models"></a>

**はい**。Credits制では、**使用するモデルのグレードに応じたCreditsが差し引かれます**。カスタマーサービスのFAQには低価格のHaikuを、詳細な分析にはOpusを使用するなど、予算配分を自由に決められます。

### Q：Creditsの使用状況を確認するにはどうすればよいですか？ <a href="#faq-view-usage" id="faq-view-usage"></a>

<mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark>に移動してください。**概要**ページにはリアルタイムの残高が表示され、**入金履歴**ページではCreditsの取得元と有効期限を確認できます。**消費履歴**ページでは使用量の明細を確認でき、CSVエクスポートにも対応しています。

### Q：月間クォータを使い切った場合はどうなりますか？ <a href="#faq-quota-exhausted" id="faq-quota-exhausted"></a>

その月のCreditsクォータを使い切ると、AIアシスタントは応答を停止します。追加のCreditsはいつでも購入でき、**購入後すぐに有効になります**。購入したCreditsは購入日から12か月間有効です。

### Q：プランの期限が切れた場合や、有料プランを契約していない場合でもプラットフォームを利用できますか？ <a href="#faq-no-active-plan" id="faq-no-active-plan"></a>

**2026年6月9日以降**、有効な有料プランがない組織（無料プラン、トライアル終了、プラン期限切れ後に未更新の場合を含む）がAI処理を必要とする操作を行うと、アップグレードを案内されます。プランの期限切れ日から**90日間**、データはプラットフォームに完全な状態で保管されます。この期間中はストレージ容量のCredits料金のみが発生し、プラン再開後にまとめて精算されます。90日以内に再契約すればすべて復元できますが、期限内に再契約しない場合、データは完全に削除され、復元できません。詳しくは、[トライアルとサブスクリプションプラン — プランの期限切れ後または無料版へのダウングレード後、データはどのように処理されますか？](/maiagent-user-guide/ja/others/trial-and-plans.md#data-retention-policy)をご覧ください。

### Q：Creditsに有効期限はありますか？ <a href="#faq-expiration" id="faq-expiration"></a>

* **月間プランクォータ**のCreditsは、その月の月末に期限切れになります
* **追加購入**したCreditsは、購入日から12か月間有効です

***

## サポートが必要ですか？お問い合わせ <a href="#contact-sales" id="contact-sales"></a>

Credits制を貴社の予算管理に活用する方法について詳しく知りたい場合や、プラン構成および追加購入についてご相談の場合は、以下の方法でお問い合わせください。

* **営業チーム**：<sales@maiagent.ai>
* **公式サイト**：<https://maiagent.ai>

MaiAgentをお選びいただき、ありがとうございます。今後も、より柔軟で費用対効果が高く、信頼できるAIサービスを提供してまいります。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/org/credits.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
