> 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/org/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 制的三大特點 <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 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>

* **不同模型，不同費率**：使用輕量模型花費少，使用旗艦模型按比例收費 — 您決定每個任務值多少錢
* **所有功能統一計費**：文字、圖片、語音、文件解析、網路搜尋等，都用 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 字的客服對話約消耗 **25–50 Credits**。加購 1,000,000 Credits 可支撐數萬次客服對話 — 而且這份額度同時可以用來處理語音、生圖、文件解析。
{% endhint %}

平台也支援圖片生成、語音轉文字、文字轉語音、文件解析、網路搜尋等功能，**全部以 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 %}

***

## 方案配額 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-589731f9acdea9f28a8b1c8605e68e6b33f18548%2Fcredits-ai-gateway-pricing.png?alt=media" alt="Credits 計費方式分頁"><figcaption><p>在「計費方式」查看各類服務的 Credits 費率。</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-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> 中使用管理介面，包含五個分頁：

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

* 即時查看 Credits 總餘額及即將到期的額度
* 月度用量趨勢圖
* 即將到期 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="#deposits-tab" id="deposits-tab"></a>

* 顯示每一筆 Credits 來源：方案發放、加購、贈送等
* 標示有效期間（每月配額月底到期、加購自購買日起 12 個月）
* 採 **FIFO 扣抵**（先到期的先扣），完整呈現各筆額度的剩餘餘額
* 支援 **CSV 匯出**，方便財務記帳與年度盤點

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

* 依日期、類型、AI 助理等多維度篩選用量明細
* 每筆消耗顯示使用的模型、消耗的 Credits、對應的事件
* 支援 **CSV 匯出** 留存或進行外部分析（內部財務對帳的好朋友）

<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：每筆用量明細皆對應模型、AI 助理與事件</p></figcaption></figure>

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

* 完整列出所有模型與功能的費率
* 涵蓋 LLM 對話、語音、知識庫、爬蟲、工具、AI 助理運算、Avatar 等所有計費類別

<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 %}

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://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-cdaf245bd3a3c0393c93c541287bd6f7b14f5f02%2Fcredits-attachment-storage-pricing.png?alt=media" alt="Credits 計費方式中的對話附件儲存與衍生檔案儲存項目"><figcaption><p>展開「知識庫與向量檢索系統」，核對兩種檔案儲存的費率。</p></figcaption></figure>

**使用情境**

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

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

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

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

***

## 餘額不足提醒 <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>

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 細節**。

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

快取項目只在模型回報對應用量時顯示。若該次請求沒有建立或命中快取，明細就不會出現相應項目；這不影響 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-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 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/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.
