Cherry Studio

更新時間:
Copy as MD

Cherry Studio 是一款開源 AI 案頭用戶端,可以通過 Token Plan 團隊版、Coding Plan或隨用隨付接入阿里雲百鍊。

安裝 Cherry Studio

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

配置接入憑證

開啟 Cherry Studio,點擊右上方的設定按鈕,在模型欄點擊添加,填寫供應商名稱(如 Token Plan 團隊版),供應商類型選擇 OpenAI。

百鍊提供三種計費方案,根據需要選擇:

  • 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 團隊版支援的模型

Coding Plan

配置項

說明

API 金鑰

填入 Coding Plan 專屬 API Key

API 地址

https://coding-intl.dashscope.aliyuncs.com/v1

模型

可用模型請參考 Coding Plan 支援的模型

隨用隨付

配置項

說明

API 金鑰

填入阿里雲百鍊 API Key

API 地址

根據地區,填入對應 URL:

  • 華北2(北京):https://dashscope.aliyuncs.com/compatible-mode/v1

  • 新加坡:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1,請將WorkspaceId替換為真實的擷取Workspace ID

  • 美國(維吉尼亞):https://dashscope-us.aliyuncs.com/compatible-mode/v1

模型

填入支援的模型

驗證配置

模型 ID填入需要使用的模型(如 qwen3.7-max),點擊添加。返回對話介面,輸入任意問題,模型正常返迴響應即配置成功。

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

常見問題

錯誤碼

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

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

原因:該模型僅支援在思考模式下運行,但調用時未開啟思考模式。

解決方案:在用戶端中開啟思考模式。

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

可能的原因:

  • 地區不匹配免費額度僅適用於新加坡地區(國際服務部署範圍)的模型。使用其他地區和部署範圍的模型會產生費用。請檢查API 地址是否與目標地區匹配,詳情請參見新人免費額度

  • 額度按模型獨立計算:各模型的免費額度相互獨立,不可跨模型共用。

  • 資料更新延遲:控制台顯示的免費額度資料每小時更新。即使控制台顯示仍有餘量,實際額度也可能已耗盡。

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