Cherry Studio

​

安裝 Cherry Studio

前往 Cherry Studio 下載頁面，根據作業系統下載安裝包並完成安裝。

​

配置接入憑證

開啟 Cherry Studio，點擊右上方的設定按鈕，在模型欄點擊添加，填寫供應商名稱（如 Token Plan 團隊版），供應商類型選擇 OpenAI。 百鍊提供四種計費方案，根據需要選擇：

• Token Plan 個人版：按 token 消耗抵扣個人 Credits。
• Token Plan 團隊版：按坐席訂閱，按 token 消耗抵扣 Credits。
• Coding Plan：固定月費訂閱，按模型調用次數計量。
• 隨用隨付：按實際調用量後付費。

​

Token Plan 個人版

配置項	說明
API 金鑰	填入 Token Plan 個人版專屬 API Key。
API 地址	https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
模型	可用模型請參考 Token Plan 個人版支援的模型。

​

Token Plan 團隊版

配置項	說明
API 金鑰	填入 Token Plan 團隊版專屬 API Key。
API 地址	https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
模型	可用模型請參考 Token Plan 團隊版支援的模型。

​

Coding Plan

配置項	說明
API 金鑰	填入 Coding Plan 專屬 API Key。
API 地址	https://coding-intl.dashscope.aliyuncs.com/v1
模型	可用模型請參考 Coding Plan 支援的模型。

​

隨用隨付

配置項	說明
API 金鑰	填入阿里雲百鍊 API Key。
API 地址	根據地區，填入對應 URL（請將 URL 中的 {WorkspaceId} 替換為真實的擷取Workspace ID）： 華北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 美國（維吉尼亞）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
模型	填入支援的模型。

​

驗證配置

在模型 ID填入需要使用的模型，點擊添加。返回對話介面，輸入任意問題，模型正常返迴響應即配置成功。

如果是 RAM 子帳號，請參見業務空間管理，確保擁有模型的調用許可權。

​

常見問題

​

錯誤碼

配置過程中遇到報錯，請參考對應計費方案的常見問題文檔：

• 隨用隨付：錯誤碼排查
• Coding Plan：Coding Plan 常見問題
• Token Plan 個人版：Token Plan 常見問題
• Token Plan 團隊版：Token Plan 團隊版常見問題

​

報錯 The value of the enable_thinking parameter is restricted to True

原因：該模型僅支援在思考模式下運行，但調用時未開啟思考模式。 解決方案：在用戶端中開啟思考模式。

​

接入隨用隨付時，有免費額度但產生了費用

可能的原因：

• 地區不匹配：免費額度僅適用於新加坡地區的模型。使用其他地區的模型會產生費用。請檢查API 地址是否與目標地區匹配，詳情請參見新人免費額度。
• 額度按模型獨立計算：各模型的免費額度相互獨立，不可跨模型共用。
• 資料更新延遲：控制台顯示的免費額度資料每小時更新。即使控制台顯示仍有餘量，實際額度也可能已耗盡。

可通過如何查看產生費用的模型？及如何查看模型調用記錄？確認費用詳情。