# MiniMax Coding Plan

**Coding Plan** 係 MiniMax 推出嘅高性價比編程訂閱服務（例如 Starter/Plus 套餐）。透過喺 Cherry Studio 入面設定呢個套餐，你可以用極低嘅固定成本（最低 ¥29/月）使用 `MiniMax-M2.1` 模型。

{% hint style="success" %}
**核心優勢**

* **適用人群**：擁有 MiniMax Coding Plan 訂閱（Starter / Plus / Max）嘅用戶。
* **計費模式**：按時段刷新額度（例如每 5 個鐘 40 次 Prompt），而唔係按 Token 計費，唔使擔心消耗太快。
  {% endhint %}

### 1. 準備工作

喺開始之前，請確保你已經買咗套餐同埋攞到密鑰：

1. 登入 [**MiniMax 開放平台**](https://platform.minimaxi.com/)。
2. 進入 [**Coding Plan** 頁面](https://platform.minimaxi.com/subscribe/coding-plan?code=FYWiC6CtHy\&source=link)，確保套餐已經生效。

   <figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2F6K9pHCESFhsRcHLPZLTa%2Fimage.png?alt=media&#x26;token=d641fe70-c879-45e6-bb9f-e3acbb0b47af" alt=""><figcaption></figcaption></figure>
3. 喺 **Coding Plan** 中複製你嘅專屬 `API Key`（以 `sk-` 開頭）。

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FAmfluvn77ATFLUXQHqLJ%2Fimage.png?alt=media&#x26;token=75143e19-5676-4e1a-89a2-a8f2634b9910" alt=""><figcaption></figcaption></figure>

### 2. 配置步驟

#### 第一步：定位服務商

進入 Cherry Studio，撳側邊欄嘅 **設定** > **模型服務**，喺列表入面搵到 **MiniMax**。

{% hint style="info" %}
如果列表比較長，可以喺頂部嘅搜尋框輸入 `mini` 快速定位。
{% endhint %}

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FcNSE2jhLYliX6BRwnBSx%2Fimage.png?alt=media&#x26;token=e289f1ec-0c81-404f-8bb6-15b03da5f126" alt=""><figcaption></figcaption></figure>

#### 第二步：填寫配置

**唔需要**唔使修改複雜嘅 API 地址，用預設配置就得，請參考以下說明填寫：

<table><thead><tr><th width="128.20703125">參數項</th><th>填寫說明</th></tr></thead><tbody><tr><td><strong>API Key</strong></td><td>貼上你嘅 Coding Plan 專屬密鑰<br><em>（注意：一定要係買咗套餐之後生成嘅 Key，唔好有多餘空格）</em></td></tr><tr><td><strong>API 地址</strong></td><td>保持預設 <code>https://api.minimaxi.com/v1</code></td></tr><tr><td><strong>開關</strong></td><td>撳右上角開關，確保為 <strong>綠色（ON）</strong></td></tr></tbody></table>

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FLem4dFI2FIbxIfVFP065%2Fimage.png?alt=media&#x26;token=32648fbd-27a9-4ece-bf61-d359f3cdb31d" alt=""><figcaption></figcaption></figure>

#### 第三步：添加指定模型（關鍵）

Coding Plan 套餐只支援特定模型，揀錯模型就用唔到，或者會產生額外費用。

1. 撳配置頁底部嘅 **管理（Manage）** 按鈕。

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fu6ubRj4ptbEMzqU1rWTP%2Fimage.png?alt=media&#x26;token=bd84fe77-1245-47bb-989a-888cf4c98a5d" alt=""><figcaption></figcaption></figure>

2. 喺列表入面搵到並添加 **`MiniMax M2.1`**。

{% hint style="warning" %}
**請務必揀正確模型！**

* ✅ **推薦**：`MiniMax M2.1` （Coding Plan 指定主力模型）。
  {% endhint %}

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FGAQgmlyV3iDLG1M69cbQ%2Fimage.png?alt=media&#x26;token=9fc5f4f6-ca17-4131-991d-eb6a2b4e747d" alt=""><figcaption></figcaption></figure>

#### 第四步：保存並驗證 <a href="#headingcab61b6e3e264a4b8e56bc83923488d2-di-si-bu-bao-cun-bing-yan-zheng-0" id="headingcab61b6e3e264a4b8e56bc83923488d2-di-si-bu-bao-cun-bing-yan-zheng-0"></a>

1. 撳 API 密鑰輸入框旁邊嘅 **檢測（Check）** 按鈕。

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fx6VeeXWy6yJFNak702Nu%2Fimage.png?alt=media&#x26;token=568783b3-9011-45a2-9e75-82bd27b8ebbb" alt=""><figcaption></figcaption></figure>

2. 如果顯示綠色 **Success**，即係你嘅 Coding Plan 套餐已經成功連接！

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Ft6LdvunQr63IgJEg9v3I%2Fimage.png?alt=media&#x26;token=53a9ff7c-80b5-4aa2-96fd-999ecb9e1973" alt=""><figcaption></figcaption></figure>

### 3. 用量與限制說明

Coding Plan 同普通 API 嘅計費模式完全唔同，請務必理解以下機制：

{% hint style="info" %}
**額度刷新機制** Coding Plan 嘅額度係**週期性刷新**嘅。例如 Starter 套餐：**每 5 個鐘** 提供 **40 次** 對話額度。

* **如果唔回應咗**：即係你而家 5 個鐘嘅額度已經用晒。
* **解決辦法**：休息幾個鐘，等額度自動恢復就得，唔使額外付費。
  {% endhint %}

### 4. 常見問題排查

{% hint style="danger" %}
**遇到 `429 Too Many Requests` 報錯？**

呢個唔係軟件故障，而係觸發咗 **Coding Plan 嘅頻控限制**。

* 即係你而家時段嘅「發訊息次數」已經用晒。
* 請耐心等下個 5 個鐘周期刷新。
  {% endhint %}

{% hint style="warning" %}
**遇到 `401 Unauthorized` 報錯？**

* 檢查 API Key 有冇多餘空格。
* 登入 MiniMax 官網確認你嘅 Coding Plan 訂閱係咪已經過期。
  {% endhint %}