> For the complete documentation index, see [llms.txt](https://docs.cherry-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/pre-basic/providers/minimax-coding-plan.md).

# 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="/files/44985655fb8c965fef0016abbc5757cdfcbda6c2" alt=""><figcaption></figcaption></figure>
3. 喺 **Coding Plan** 入面複製你嘅專屬 `API Key`（以 `sk-` 開頭）。

<figure><img src="/files/20b60cfa3030bc0fc5eee3025c3b64c18f034c86" alt=""><figcaption></figcaption></figure>

### 2. 配置步驟

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

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

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

<figure><img src="/files/1f3c99e53d052dfb4de5f106fb21fcbc4f7991b9" 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="/files/db13d6b3eb452fd075b80f216eb4fe4d6da35fb7" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/267df2411306c7d87ab5b7e97e7a98db2a6c5e6c" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/7c478f910ddcfbf08936d23b30f83f690c6b156c" 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="/files/6ac6e97b5090a7cee7af191f926a5a8452a9638f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/f0ae153827e0f35ac80c0778e4f020a46107ebe2" 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 %}

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 [反饋同建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# 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.cherry-ai.com/docs/zhong-wen-fan-ti/pre-basic/providers/minimax-coding-plan.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.