> 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/others/credits.md).

# Credits 計費制度

MaiAgent 平台的 Credits 點數計費制度、模型費率表與價格（定價）查詢 — 一份額度涵蓋所有 AI 功能。

{% hint style="success" %}
✨ **MaiAgent 採用 Credits 點數制計費** — 一份額度同時涵蓋對話、語音、圖片生成、文件解析等所有 AI 功能，模型依等級計費，用量透明可追蹤。
{% endhint %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-ddb6a71dfed0998f8b18369fa94f0875e72b8442%2Fcredit-illustration-1-hero.png?alt=media" alt=""><figcaption><p>Credits 計費制度 — 一份額度涵蓋所有 AI 功能</p></figcaption></figure>

本頁內容：[Credits 制的三大特點](#credits-highlights)｜[什麼是 Credits？](#what-is-credits)｜[主要模型 Credits 費率](#model-rates)｜[各方案可用 tokens 參考](#plan-token-reference)｜[Credits 加購方案](#topup-plans)｜[方案配額 vs 加購額度的關係](#plan-vs-topup)｜[AI Gateway 自建模型的流量費](#ai-gateway-traffic-fee)｜[Credits 管理面板](#management-panel)｜[餘額不足提醒](#low-balance-alert)｜[Prompt Cache 快取用量](#prompt-cache-usage)｜[常見問題](#faq)｜[需要協助？聯繫我們](#contact-sales)

## Credits 制的三大特點 <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://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c4dfe904ceee4ce7bfcd6656895e75aee384496d%2Fcredit-illustration-2-all-in-one.png?alt=media" alt=""><figcaption><p>一份 Credits 額度，同時支撐對話、語音、圖片生成、文件解析、網路搜尋與工具呼叫</p></figcaption></figure>

### 2. 模型依等級計費，預算控制權回到您手上 <a href="#multi-model-budget-control" id="multi-model-budget-control"></a>

不同 AI 模型成本差異最大可達 **數十倍**，Credits 制下這份差異會直接反映在費用上：

* 一般客服 FAQ → 用 **Claude 4.5 Haiku** 這類輕量模型節省成本
* 複雜分析、深度研究 → 用 **Claude 5.5 Opus** 這類旗艦模型換取品質
* 多個 Agent 各自使用不同模型，依等級費率扣 Credits，預算如何分配由您決定

### 3. 透明可追蹤，財務對帳變簡單 <a href="#transparent-tracking" id="transparent-tracking"></a>

每一筆 Credits 消耗都對應到 **使用的模型、功能類型、Agent**，可在管理面板即時查詢、依任意維度篩選、匯出 CSV 做內部報表。**不再有「不知道錢花在哪」的困擾。**

***

## 什麼是 Credits？ <a href="#what-is-credits" id="what-is-credits"></a>

Credits 是 MaiAgent 平台的**通用計費單位**。每一次 AI 對話、圖片生成、語音處理、文件解析等操作，都會根據使用的模型和功能消耗對應的 Credits。

### 核心原則 <a href="#core-principles" id="core-principles"></a>

* **不同模型，不同費率**：使用輕量模型花費少，使用旗艦模型按比例收費 — 您決定每個任務值多少錢
* **所有功能統一計費**：文字、圖片、語音、文件解析、網路搜尋等，都用 Credits 統一衡量
* **透明可追蹤**：管理面板即時查看 Credits 餘額和每筆用量明細，支援 CSV 匯出
* **先進先扣**：採 FIFO 順序自動扣抵，**較早到期的 Credits 優先使用**，避免過期浪費

***

## 主要模型 Credits 費率 <a href="#model-rates" id="model-rates"></a>

每個模型的 **Input 與 Output 分開計價**。下表是幾個常用模型的費率，只作為比較等級差異的示例，不是完整價目表。

**示例（2026-10）**，單位為每 100 萬 tokens 的 Credits：

| 模型                    | Input Credits / 1M tokens | Output Credits / 1M tokens |
| --------------------- | ------------------------- | -------------------------- |
| **Claude 5.5 Opus**   | 79,200                    | 396,000                    |
| **Claude 5.5 Sonnet** | 39,600                    | 198,000                    |
| **Claude 4.5 Haiku**  | 19,800                    | 99,000                     |
| **GPT-6.1 Sol**       | 39,600                    | 198,000                    |
| **GPT-6 Luna**        | 1,980                     | 9,900                      |
| **Gemini 3.8 Flash**  | 14,850                    | 74,250                     |

{% hint style="warning" %}
費率會隨模型上下架與原廠調價而變動，實際扣點一律以後台「計費方式」當下顯示的費率為準。組織實際能選用哪些模型，依 [模型調用權限](/org/model-access.md) 而定；每個模型目前的 Credits 價格、速度與退役日期，也可以直接在該頁的模型清單查看。
{% endhint %}

{% hint style="info" %}
**實際用量範例**：以 **Claude 4.5 Haiku** 為例，一次約 500 字的客服對話約消耗 **25–50 Credits**。加購 1,000,000 Credits 可支撐數萬次客服對話 — 而且這份額度同時可以用來處理語音、生圖、文件解析。
{% endhint %}

平台也支援圖片生成、語音轉文字、文字轉語音、文件解析、網路搜尋等功能，**全部以 Credits 統一計費，不需要另外加購**。知識庫文件解析與爬蟲的計費單位，請見 [用量計算：知識庫處理計費](/others/usage.md#knowledge-base-processing-billing)。

[自動評估](/build/agent-ops/evaluations.md)執行時，Agent 為每個測試案例產生回答所用的模型 tokens、查詢向量化與重排序，會依該模型的對話費率扣點，與評測模型本身的費用一併歸在該次評估底下；使用自備金鑰（BYOK）的模型不扣回答 tokens 的點數。在 <mark style="color:blue;">**消耗記錄**</mark> 可以看到這些費用歸屬於哪一次評估。

### 從評估費用查看測試結果 <a href="#evaluation-credit-results" id="evaluation-credit-results"></a>

組織管理員核對客服 Agent 的測試費用時，想知道一筆消耗對應哪次測試。她在 <mark style="color:blue;">消耗記錄</mark> 找到 <mark style="color:blue;">測試集評估</mark> 的消耗列，點選可開啟的 <mark style="color:blue;">ID</mark>，便能查看該次評測結果，將實際費用與測試成果一起核對。

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> 的消耗列。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-2bcd60c4e868bd2742d0d4d2dae1e84f0905755d%2Fcredits-evaluation-ledger.png?alt=media" alt="消耗記錄中，測試集評估與對話訊息分列顯示費用，記錄 ID 已遮蔽"><figcaption><p>從「測試集評估」消耗列對帳；圖中記錄 ID 已遮蔽</p></figcaption></figure>

3. 若該列的 <mark style="color:blue;">ID</mark> 可點選，點擊即可開啟對應的評測結果頁，查看測試成果。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-826d13d9875f8a966bd7e4cca5a2a6a09216131f%2Fcredits-evaluation-results.png?alt=media" alt="單輪評測結果頁的頂部，顯示評測名稱、已完成狀態、成功率與平均秒數"><figcaption><p>點選可開啟的 ID 後，進入該次評測的結果頁</p></figcaption></figure>

{% hint style="info" %}
能查看的結果仍依您的權限與 Agent 可見範圍而定。ID 若顯示為不可點選的純文字，可請組織管理員協助確認查看權限。
{% endhint %}

### 在後台查看完整費率 <a href="#view-full-rates" id="view-full-rates"></a>

1. 進入 <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**計費方式**</mark>。
2. 展開 <mark style="color:blue;">**AI 文字生成與理解模型**</mark> 分類。
3. 點開 <mark style="color:blue;">**LLM 輸入**</mark> 或 <mark style="color:blue;">**LLM 輸出**</mark> 等計費項目，底下每一列是一個模型的費率，標示供應商與模型代碼。
4. 需要整份費率表時，點頁面上方的 <mark style="color:blue;">**匯出 CSV**</mark>。

{% hint style="info" %}
「計費方式」的語言模型費率以 <mark style="color:blue;">**每千 Tokens**</mark> 顯示，乘以 1,000 就是上表「每 100 萬 tokens」的數字。例如 Claude 4.5 Haiku 的 LLM 輸入在後台顯示 19.80，等於上表的 19,800。
{% endhint %}

### 為什麼同一個模型有不同費率 <a href="#same-model-different-rates" id="same-model-different-rates"></a>

同一個模型可能透過不同的供應商提供服務，例如 GPT-6 Luna 有 OpenAI 與 Azure OpenAI 兩種來源，GPT-6 Astra 有 AWS Bedrock 與 Azure OpenAI 兩種來源。每個供應商各有一筆定價規則，費率依該供應商的牌價訂定，所以在「計費方式」裡可能看到同名模型出現多列，價格也可能不同。

每一次扣點都依該次實際使用的供應商與模型計算。想確認某筆費用用的是哪一個，請到 <mark style="color:blue;">**消耗記錄**</mark> 展開該筆消費，查看 <mark style="color:blue;">**提供者**</mark> 與 <mark style="color:blue;">**模型**</mark> 欄位。

***

## 各方案可用 tokens 參考 <a href="#plan-token-reference" id="plan-token-reference"></a>

依使用的模型不同，同樣的 Credits 可處理的 token 量差異如下（以上表費率、70% Input＋30% Output 的混合比例估算）：

| 方案  | 每月 Credits | Claude 4.5 Haiku 約可處理 | Claude 5 Sonnet 約可處理 | Claude 5.5 Opus 約可處理 |
| --- | ---------- | --------------------- | -------------------- | -------------------- |
| 標準版 | 500,000    | \~1,148 萬 tokens      | \~574 萬 tokens       | \~287 萬 tokens       |
| 專業版 | 5,000,000  | \~11,478 萬 tokens     | \~5,739 萬 tokens     | \~2,870 萬 tokens     |
| 企業版 | 10,000,000 | \~22,957 萬 tokens     | \~11,478 萬 tokens    | \~5,739 萬 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      |

各加購方案的價格在後台 <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**帳單管理**</mark> 的 <mark style="color:blue;">**加購 Credits**</mark> 分頁查看並結帳（需要帳單管理權限），價格以該頁顯示為準；方案由合作夥伴管理的組織，加購請向合作夥伴洽詢。

{% hint style="info" %}
**過期規則**\
• **每月方案配額** 的 Credits 於當月月底到期\
• **加購** 的 Credits 自購買日起 **12 個月內** 有效，未使用的 Credits 將於到期後失效
{% endhint %}

***

## 方案配額 vs 加購額度的關係 <a href="#plan-vs-topup" id="plan-vs-topup"></a>

訂閱方案的「**每月配額**」與「**加購 Credits**」是兩個獨立但互補的額度。系統會自動處理扣抵順序，您不需手動分配。

### 兩者比較 <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 %}

### 為什麼要分兩種？ <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://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-a823e0441e825808d7c29e19b30f6b5b72ee41fa%2Fcredits-ai-gateway-pricing.png?alt=media" alt="平台費用分類中的 AI Gateway 流量費"><figcaption><p>在「計費方式」的「平台費用」分類查看 AI Gateway 流量費。</p></figcaption></figure>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-02c47652d64133d1b0dedfb67f7529765f791928%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> 中使用管理介面，包含五個分頁：

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

* 即時查看 Credits 總餘額及即將到期的額度
* 消耗趨勢圖：可自訂任意日期區間，卡片上同步顯示區間消耗與日均（詳見 [自訂消耗趨勢的日期區間](#trend-date-range)）
* 即將到期 Credits 提醒
* 餘額不足提醒設定（站內通知 + Email，詳見 [餘額不足提醒](#low-balance-alert)）

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-3f607a177e928d881df79b615c86203016151fb9%2Fcredit-1-overview.png?alt=media" alt=""><figcaption><p>概覽 Tab：即時 Credits 餘額與到期提醒</p></figcaption></figure>

#### 自訂消耗趨勢的日期區間 <a href="#trend-date-range" id="trend-date-range"></a>

「消耗趨勢」卡片右上角是一個日期範圍選擇器，預設顯示近 30 天。想看上個月或任何一段期間花了多少 Credits，不必再匯出報表自己加總。

1. 進入 <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**概覽**</mark>。
2. 點「消耗趨勢」卡片右上角的日期範圍，在同一個日曆面板先點起始日、再點結束日；面板左側也有 <mark style="color:blue;">**近 7 天**</mark>、<mark style="color:blue;">**近 30 天**</mark>、<mark style="color:blue;">**本月**</mark>、<mark style="color:blue;">**上月**</mark> 四個快捷選項。
3. 圖表立即改畫該區間的每日消耗，卡片上的 <mark style="color:blue;">**區間消耗**</mark> 與 <mark style="color:blue;">**日均**</mark> 跟著重算；卡片底部會標示「共 N 天」。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-06ce169732c6c58365c6df06d785fb6497ada70f%2Fcredits-trend-range-picker.png?alt=media" alt="消耗趨勢卡片的日期範圍選擇器，面板左側有近 7 天、近 30 天、本月、上月四個快捷選項"><figcaption><p>消耗趨勢：在日曆面板點選起迄日，或直接用左側快捷選項</p></figcaption></figure>

{% hint style="info" %}

* 起迄日以台灣時間的整日計算，含起迄兩端；結束日不可晚於今天。
* 區間在 90 天以內逐日一點；超過 90 天改為逐週一點，橫軸標籤改為每週的起始日。「日均」一律以區間天數計算，不受逐週顯示影響。
* 區間內沒有任何消耗時，圖表顯示空狀態。
  {% endhint %}

### 入帳紀錄 <a href="#deposits-tab" id="deposits-tab"></a>

* 顯示每一筆 Credits 來源：方案發放、加購、贈送等
* 標示有效期間（每月配額月底到期、加購自購買日起 12 個月）
* 採 **FIFO 扣抵**（先到期的先扣），完整呈現各筆額度的剩餘餘額
* 支援 **CSV 匯出**，方便財務記帳與年度盤點；匯出在背景產檔，到 [匯出記錄](#export-records) 頁下載

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-841869bbc95eef21c7f52365b382ceeb69cce267%2Fcredit-2-deposits.png?alt=media" alt=""><figcaption><p>入帳紀錄 Tab：完整呈現 Credits 來源、有效期與剩餘餘額</p></figcaption></figure>

### 消耗記錄 <a href="#consumption-tab" id="consumption-tab"></a>

* 依日期、類型、Agent 等多維度篩選用量明細
* 每筆消耗顯示使用的模型、消耗的 Credits、對應的事件
* 篩選後直接顯示這批結果的消費合計、入帳合計、筆數與日均消費（詳見 [篩選結果統計](#consumption-stats)）
* <mark style="color:blue;">**服務類別**</mark> 選 <mark style="color:blue;">**AI 記憶**</mark> 可單獨查看 AI 記憶整理成員記憶的消耗（詳見 [查看 AI 記憶的消耗](#ai-memory-consumption)）
* 支援 **CSV 匯出** 留存或進行外部分析（內部財務對帳的好朋友）；匯出的是目前篩選條件下的完整明細（非統整模式），在背景產檔後到 [匯出記錄](#export-records) 頁下載

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9265ca5f54d3d1ca372e22bb884fccbd26408e54%2Fcredit-3-consumption.png?alt=media" alt=""><figcaption><p>消耗記錄 Tab：每筆用量明細皆對應模型、Agent 與事件</p></figcaption></figure>

#### 篩選結果統計 <a href="#consumption-stats" id="consumption-stats"></a>

財務人員月底要核對「上個月到底扣了多少 Credits」時，只要在消耗記錄把日期範圍設成整個月，篩選卡下方的統計列就會直接給出合計，不必匯出 CSV 再自己加總。

設定交易類型、服務類別、日期範圍或搜尋關鍵字後，篩選卡與明細表之間會出現一列統計，並標示目前的統計範圍：

<table><thead><tr><th width="150">欄位</th><th>說明</th></tr></thead><tbody><tr><td>消費合計</td><td>篩選範圍內所有扣款的加總（含平台處理費），與匯出 CSV 的加總一致。交易類型選「入帳」時顯示 0。</td></tr><tr><td>入帳合計</td><td>篩選範圍內所有儲值、發放、退款的加總。交易類型選「消費」時顯示 0。</td></tr><tr><td>筆數</td><td>與明細表底部「共 N 筆」相同；同一則訊息的多條扣款合併算一筆。</td></tr><tr><td>日均消費</td><td>消費合計 ÷ 日期範圍天數（含起迄兩端）。沒有設定日期範圍時顯示「–」。</td></tr></tbody></table>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-79df7a40390511c20904035bb55b1d15ad59a342%2Fcredits-consumption-stats-row.png?alt=media" alt="消耗記錄分頁：篩選卡下方的統計列顯示消費合計、入帳合計、筆數與日均消費"><figcaption><p>把日期範圍設成整個月，統計列直接顯示該月的消費合計與日均</p></figcaption></figure>

{% hint style="info" %}
統計以篩選後的整批結果計算，不受分頁與每頁筆數影響；每次改變篩選條件都會重算。若統計暫時載入失敗，明細表仍會正常顯示，點統計列上的重試即可重新計算。
{% endhint %}

#### 查看 AI 記憶的消耗 <a href="#ai-memory-consumption" id="ai-memory-consumption"></a>

[AI 記憶](/work/maigpt/ai-memory.md)從對話中整理、儲存成員的記憶時，會由平台的系統模型執行，並依該模型的費率扣 Credits。每次整理都會在 <mark style="color:blue;">**消耗紀錄**</mark> 單獨列出，服務類別為 <mark style="color:blue;">**AI 記憶**</mark>，不會併進 Agent 回覆本身的用量。

**使用情境**

行銷企劃在 MaiGPT 告訴 Agent：「我是 Acme 示範公司的行銷企劃，之後回覆請一律用條列式」。對話告一段落後，AI 記憶把「職務」和「回覆格式偏好」整理成兩條記憶。月底組織管理員核對 Credits 時，在 <mark style="color:blue;">**消耗紀錄**</mark> 把 <mark style="color:blue;">**服務類別**</mark> 切到 <mark style="color:blue;">**AI 記憶**</mark>，就看到這次整理的消耗、執行的模型和被記住的成員，並能跟 Agent 回覆的費用分開核對。

**操作步驟**

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;">**AI 記憶**</mark>。列表與上方的 [篩選結果統計](#consumption-stats) 只計算 AI 記憶的消耗；選 <mark style="color:blue;">**AI 語言模型**</mark> 時則不含這些消耗。
3. 點選一筆消耗左側的展開圖示查看明細：
   * 明細名稱顯示 <mark style="color:blue;">**AI 記憶（輸入）**</mark>、<mark style="color:blue;">**AI 記憶（輸出）**</mark>；快取等其他計費項目顯示 <mark style="color:blue;">**AI 記憶**</mark>，名稱旁的灰色文字是計費項目代碼。
   * <mark style="color:blue;">**模型**</mark> 欄是實際執行整理的平台系統模型，可能與 AI 助理設定的模型不同。
   * 該筆消耗的 <mark style="color:blue;">**操作者**</mark> 是被記住的那位成員；這筆消耗也會從他的個人額度與所屬角色的角色額度扣除（有設定 [成員 Credits 額度](/others/credits/member-credit-quota.md) 或 [角色額度](/others/credits/member-credit-quota.md#role-quota) 時）。
4. 將游標移到名稱旁的資訊圖示，會顯示：「此筆為 AI 記憶從對話中整理、儲存使用者記憶所消耗的用量，由平台的系統模型執行，顯示的模型可能與 AI 助理設定的模型不同。同一則訊息可能有多次抽取（例：回覆當下與回覆後各一次），每次各計一筆。」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-3b9c787bff300c3638398c505278b68309c47e17%2Fcredits-ai-memory-detail.png?alt=media" alt="消耗紀錄展開一筆 AI 記憶消耗，明細列出 AI 記憶（輸入）、AI 記憶、AI 記憶（輸出）三行，模型為平台系統模型，滑過資訊圖示顯示 AI 記憶的說明；記錄 ID 與操作者已遮蔽"><figcaption><p>AI 記憶的明細分輸入、輸出列出，資訊圖示說明這筆用量的來源；圖中記錄 ID 與操作者已遮蔽</p></figcaption></figure>

**回覆輸入中的 AI 記憶**

Agent 回覆時參考的記憶，會跟提問一起送給模型，算在該則回覆的輸入用量裡，不屬於「AI 記憶」服務類別。為了看出輸入裡有多少是記憶，展開該則回覆的明細時，<mark style="color:blue;">**LLM 輸入**</mark>、<mark style="color:blue;">**LLM Cache 建立**</mark> 或 <mark style="color:blue;">**LLM Cache 讀取**</mark> 旁會出現資訊圖示，滑過顯示「本則輸入含 AI 記憶約 N tokens，已計入輸入用量」。N 是該行計費到的記憶 tokens 估算值；這則回覆沒有帶入記憶時不會出現圖示。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-281cd605e76be6a0757dfa12e612686978d06a97%2Fcredits-ai-memory-input-hint.png?alt=media" alt="消耗紀錄展開一則對話訊息，LLM Cache 建立旁的資訊圖示顯示「本則輸入含 AI 記憶約 187 tokens，已計入輸入用量」；記錄 ID 與操作者已遮蔽"><figcaption><p>回覆的輸入行標出其中約有多少 tokens 來自 AI 記憶；圖中記錄 ID 與操作者已遮蔽</p></figcaption></figure>

{% hint style="info" %}

* AI 記憶可能在 Agent 回覆之後才整理，所以這類消耗可能比該則回覆的消耗晚出現；同一則訊息也可能有多筆。
* 消耗紀錄只有角色具備 <mark style="color:blue;">Credit 管理權限</mark> 的成員能查看。
* 不希望自己的對話產生 AI 記憶消耗，可在 AI 記憶頁關閉 <mark style="color:blue;">讓助理記住我</mark>，詳見 [開啟或關閉 AI 記憶](/work/maigpt/ai-memory.md#toggle-memory)。
  {% endhint %}

### 計費方式 <a href="#pricing-tab" id="pricing-tab"></a>

* 完整列出所有模型與功能的費率
* 涵蓋 LLM 對話、語音、知識庫、爬蟲、工具、Agent 運算、Avatar 等所有計費類別
* 頁面上方的 <mark style="color:blue;">**匯出 CSV**</mark> 可匯出整份費率表，在背景產檔後到 [匯出記錄](#export-records) 頁下載

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-081859f5a3b6da7807f239ffd940f0ef69ca22f8%2Fcredit-4-pricing.png?alt=media" alt=""><figcaption><p>計費方式 Tab：所有模型與功能的完整費率表</p></figcaption></figure>

#### 查看對話附件與衍生檔案儲存費 <a href="#attachment-and-derived-storage" id="attachment-and-derived-storage"></a>

對話中上傳的檔案會占用「對話附件儲存」。系統解析檔案時產生的格式轉換、重新解析或語音轉錄副本另外計費：來自對話附件或檔案庫檔案的副本計入「檔案庫衍生檔案儲存」，來自知識庫檔案的副本計入「衍生檔案儲存」。這些項目都以 MB／月為計費單位，並依實際用量按日扣除 Credits；原始檔由對應的儲存項目計費，不會再以衍生檔案重複計費。

{% hint style="info" %}
對話附件的保留天數以系統設定為準，目前可在「對話附件儲存」的說明中查看。對話有新訊息時，保留倒數會重新計算；保留期結束後，附件與由它產生的處理副本會自動刪除並停止計費。刪除後無法復原，請在期限前下載需要長期保存的檔案。
{% endhint %}

{% hint style="info" %}
**保留天數在哪裡調整？**

保留天數是整個平台共用的系統設定，組織後台沒有調整的欄位，也不能依組織或對話平台個別設定。地端部署由系統管理員在系統管理端設定，範圍為 1 到 365 天。自動刪除的對象只有對話附件與它的處理副本，對話中的文字訊息不會跟著刪除。雲端版需要不同的保留期，或想確認目前的天數時，請洽 MaiAgent 窗口。
{% 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 和計費單位；將游標移到資訊圖示，可查看保留與計費說明。知識庫檔案的處理副本，則在 <mark style="color:blue;">**知識庫與向量檢索系統**</mark> 的 <mark style="color:blue;">**衍生檔案儲存**</mark>。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-bfe47589fdcfb575230ccea0eb7f673a21d93abc%2Fcredits-attachment-storage-pricing.png?alt=media" alt="Credits 計費方式的檔案庫分類，列出檔案庫儲存、對話附件儲存與檔案庫衍生檔案儲存，各 4.75 Credits 每 MB/月"><figcaption><p>核對對話附件與處理副本的儲存費率。</p></figcaption></figure>

**使用情境**

小麥公司的客服主管定期讓訪客在對話中上傳問題截圖。月底對帳時，她進入 Credits 的「計費方式」，展開「檔案庫」，確認對話附件和解析副本各自使用哪一項費率。看到附件保留說明後，她在期限前下載需要留存的截圖；不再使用的附件則會在保留期結束後自動刪除，後續不再累積儲存費。

#### 查看檔案庫儲存費 <a href="#file-library-storage" id="file-library-storage"></a>

存放在 [檔案庫](/work/file-library.md) 的檔案（個人空間、組織空間與共用空間）以 MB／月計費，每 MB 每月 **4.752 Credits**（每 GB 每月約 4,866 Credits），與知識庫原始檔案的儲存費相同，依實際用量按日扣除。檔案保留的舊版本也計入用量。

檔案庫只存放檔案、不做向量化，因此**沒有**知識庫的向量儲存費。知識庫檔案、對話附件與檔案庫各自計費，同一個檔案不會重複收費。

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>、<mark style="color:blue;">**對話附件儲存**</mark> 與 <mark style="color:blue;">**檔案庫衍生檔案儲存**</mark>（解析檔案時產生的處理副本），每 MB 每月都是 4.752 Credits。
3. 要看目前用了多少空間，到 <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**組織概覽**</mark> 的 <mark style="color:blue;">**檔案庫空間**</mark> 卡：顯示總佔用、個人／組織／共用空間各佔多少與版本快照佔用，展開個人空間可看到用量最多的成員。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-696026c688f2b44c2863550312a730312dea59e0%2Ffile-library-usage-card.png?alt=media" alt="組織概覽的檔案庫空間卡，顯示總佔用、個人空間成員排行、組織空間、共用空間與版本快照佔用"><figcaption><p>組織概覽的「檔案庫空間」卡（需組織概覽權限）</p></figcaption></figure>

**使用情境**

組織管理員月底檢視 Credits 消耗，發現檔案庫儲存費比上個月高。她打開組織概覽的「檔案庫空間」卡，展開個人空間，看到某位同事上傳了大量影片；請對方把不再需要的影片下載封存後刪除，下個月的儲存費就回到原本的水準。

### 額度分配 <a href="#quota-tab" id="quota-tab"></a>

* 管理員可為每位成員設定個人 Credits 消費上限與有效期限
* 支援分發、編輯、停用額度，以及「需要額度」開關管控
* 可搜尋篩選成員、依狀態（啟用中 / 已過期 / 未分配）過濾

詳見 [成員 Credits 額度管理](/others/credits/member-credit-quota.md)。

### 匯出記錄：下載匯出的 CSV <a href="#export-records" id="export-records"></a>

入帳紀錄、消耗記錄與計費方式三個分頁的 <mark style="color:blue;">**匯出 CSV**</mark> 都不是立即下載檔案，而是建立一筆匯出任務在背景產檔：

1. 按下 <mark style="color:blue;">**匯出 CSV**</mark> 後，畫面顯示「匯出請求已建立，正在處理中...」，並自動跳到 <mark style="color:blue;">**匯出記錄**</mark> 頁對應的分頁
2. 匯出記錄頁有三個分頁，對應三種來源：<mark style="color:blue;">**儲值紀錄**</mark>（入帳紀錄）、<mark style="color:blue;">**交易紀錄**</mark>（消耗記錄）、<mark style="color:blue;">**計費規則**</mark>（計費方式）
3. 每筆任務顯示狀態、建立者、記錄數、檔案大小、處理時長與完成時間。狀態從 <mark style="color:blue;">**等待中**</mark>、<mark style="color:blue;">**處理中**</mark> 變成 <mark style="color:blue;">**已完成**</mark> 時會自動更新，不必手動重新整理
4. 已完成的任務按操作欄的 <mark style="color:blue;">**下載**</mark> 取得 CSV；<mark style="color:blue;">**失敗**</mark> 的任務可按 <mark style="color:blue;">**查看錯誤詳情**</mark>；不再需要的任務可 <mark style="color:blue;">**刪除**</mark>

{% hint style="info" %}
匯出記錄頁沒有左側選單入口，要從三個分頁的 <mark style="color:blue;">**匯出 CSV**</mark> 進入；頁面網址帶有分頁參數，重新整理或分享網址都會回到同一個分頁。頁內分頁名稱（儲值紀錄／交易紀錄／計費規則）與 Credits 頁的分頁名稱（入帳紀錄／消耗記錄／計費方式）不同，但指的是同一份資料。
{% endhint %}

***

## 餘額不足提醒 <a href="#low-balance-alert" id="low-balance-alert"></a>

當組織 Credits 餘額跌破您設定的門檻時，系統會**主動發出預警**，讓您及早加值、避免服務中斷。預警透過**站內通知**發送，付費方案並會**自動寄送 Email**，不必登入後台也能第一時間收到提醒。

{% hint style="info" %}
站內通知所有方案皆可使用；**Email 通知僅限付費方案**。透過 AWS Marketplace 計費的組織不適用本提醒。設定與檢視提醒需具備 Credit 頁面的存取權限。
{% endhint %}

### 通知管道 <a href="#alert-channels" id="alert-channels"></a>

| 管道           | 說明                      |
| ------------ | ----------------------- |
| **站內通知**     | 餘額跌破門檻時於後台建立公告          |
| **Email 通知** | 付費方案加寄預警信給擁有者角色成員與自訂收件人 |

兩個管道共用同一組**啟用開關**與**提醒門檻**：關閉提醒後，站內通知與 Email 都會停止。

### 誰會收到 Email <a href="#alert-recipients" id="alert-recipients"></a>

* **擁有者角色的所有成員**：開啟提醒後自動納入，一律寄送
* **自訂收件人**：組織可自行填入最多 **5 個** Email，作為額外加寄對象
* 兩者若有重複，系統會**自動去重**，同一 Email 只會收到一封

### 設定方式 <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 小時最多寄送一次**，避免重複打擾
* 預警信為品牌化 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>

Agent 每次回覆時，其實都要把**整段對話的背景資料**重新送進模型 — 包含角色指令（System Prompt）、知識庫內容、以及先前的對話內容。這些內容在同一個 Agent 的多次對話之間**高度重複**：角色指令每次都一樣、知識庫片段常常相同。

**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>

組織管理員想確認 Agent 近期是否透過快取降低成本時，可以先在 <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）較長的 Agent**：例如客服助理帶有完整的應對規範、產品說明；後續請求命中相同快取時，較多內容可按讀取費率計費
* **高頻使用的 Agent**：相同內容在快取有效期間內被後續請求命中的次數越多，越有機會抵銷建立快取的成本
* **多輪長對話**：若模型能重複利用先前對話內容，後續輪次可能產生較多快取讀取用量

### 在哪裡查看快取用量 <a href="#where-to-view-cache-usage" id="where-to-view-cache-usage"></a>

平台提供三個層次的檢視位置：從**逐筆帳務明細**、**組織彙總統計**、到**單則對話的 Token 細節**。

#### 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> 分頁，可查看各模型快取項目的費率（每千 Token 計價）

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%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://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0e4cb43b0bda7d8a1a165c3e4eb8323cf15de696%2Fcache-02-savings-card.png?alt=media" alt="用量概覽的快取節省數字"><figcaption><p>用量概覽：淨節省大於 0 時顯示「快取節省」</p></figcaption></figure>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-15e401a076373ed369f3f0ad4409aa373f80784c%2Fusage-stats-credit-categories.png?alt=media" alt="用量統計「計費類別」分頁：LLM Cache 建立／讀取兩個計費項目"><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://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%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>

快取項目只在模型回報對應用量時顯示。若該次請求沒有建立或命中快取，明細就不會出現相應項目；這不影響 Agent 正常回覆。

***

## 常見問題 <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 配額用盡後，Agent 將暫停回應。您可以隨時加購額外的 Credits，**加購後立即生效**，加購的 Credits 自購買日起 12 個月內有效。

### Q：方案到期或沒有付費方案時，還能使用平台嗎？ <a href="#faq-no-active-plan" id="faq-no-active-plan"></a>

**自 2026-06-09 起**，沒有啟用中付費方案的組織（含免費方案、試用結束、方案到期未續訂），進行需要 AI 運算的操作時會引導升級。資料自方案到期日起由平台完整保管 **90 天**，期間僅產生儲存空間的 Credits 費用（恢復方案後一併結算），90 天內重新訂閱即可完整恢復；逾期未訂閱將永久清除、無法復原。詳見 [試用與訂閱方案 — 方案到期或降為免費版後，資料會如何處理？](/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/others/credits.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.