文件快速開始基礎知識
分組是什麼
理解 MoleAPI 分組與模型可用性、價格策略、穩定性之間的關係
在 MoleAPI 裡，分組 可以理解為「某個 API Key 走哪一套模型通道與價格策略」。
它不是一個純展示欄位，而是會直接影響：
- 這個 Key 能看到哪些模型
- 呼叫這些模型時走哪類通道
- 對應的價格策略
- 某些情況下的穩定性與適用場景
為什麼要有分組
如果平台把所有模型、所有價格、所有通道都混在一起，使用者很難依用途做區分。
分組的存在，就是為了讓你能把不同目標拆開管理，例如：
- 測試環境和正式環境走不同分組
- 成本敏感的流量走更便宜的組
- 穩定性優先的流量走更穩的組
- 某些特定模型只允許特定 Key 使用
你可以把分組理解成什麼
一個更貼近實際的理解是：
分組 = 模型集合 + 通道策略 + 價格策略 的組合
所以即使是同一個模型，在不同分組下，也可能出現：
- 可用性不同，切換分組會導致模型不可用
- 單價不同，部分有折扣
- 穩定性體驗不同，例如 relay 分組穩定性可能較差
在控制台定價頁的左側篩選中選擇「可用令牌分組」，即可查看該分組下可見的模型清單。
常見分組類型
以下是文件裡最常見、也最容易理解的幾類：
| 分組類型 | 特點 | 適合場景 |
|---|---|---|
default | 預設分組，通常更穩、更通用 | 正式專案、長期使用 |
discount | 活動或優惠分組 | 成本敏感、願意關注活動變化 |
relay | 價格通常更低，但體驗可能更依賴具體通道 | 測試、實驗、對成本更敏感的場景 |
實際以控制台和系統公告中的目前分組資訊為準。
新手應該怎麼選
如果你是第一次接入，建議：
- 先用預設分組 跑通流程
- 跑通後再根據價格、模型覆蓋和穩定性做調整
這是因為對新手來說，先成功比先極限省錢更重要。
什麼時候要認真區分分組
下面這些場景，建議你明確規劃分組：
1. 正式環境和測試環境分離
不要讓測試流量和正式業務混在同一策略裡。
2. 想控制成本
如果你對價格很敏感，分組會是非常重要的調節手段。
3. 不同系統權限不同
例如：
- 內部實驗專案可以使用較便宜的分組
- 正式產品只開放少數穩定模型
4. 你想觀察不同通道效果
有時同一模型在不同分組下的體驗會不同，適合先小流量測試，再決定長期策略。
分組和 API Key 的關係
分組通常是設定在 API Key 上的。建立或編輯 API Key 時，在「令牌分組」處選擇該 Key 所屬分組（如 default、discount、relay），不同分組對應不同倍率與模型範圍。
這意味著：
- 不同 Key 可以走不同分組
- 同一個帳號可以同時擁有多種策略
- 你可以依專案或環境分配不同 Key，再替它們設定不同分組
這也是為什麼我們常常建議：
- 一個測試 Key
- 一個正式 Key
- 必要時每個系統各自一個 Key
使用建議
推薦做法
- 新手先用
default - 依環境拆分多個 Key
- 重要業務先求穩定，再考慮更便宜的分組
- 上線前在目標分組裡先做實際測試
不推薦做法
- 所有專案共用一個 Key 和一個分組
- 對分組不了解時，直接把正式流量切到陌生分組
- 只看價格，不看模型可用性和穩定性
一句話建議
先用預設分組跑通，再依成本、模型和穩定性需求做分組最佳化。
下一步看什麼
這篇文件對您有幫助嗎？
最後更新於