在 Cherry Studio 中使用阿里雲百鍊模型。
快速開始
- 1
獲取 API Key
根據計費方案獲取對應的 API Key:
- Token Plan 個人版:建立或查看 API Key
- Token Plan 團隊版:分配席位並取得 API Key
- 按量計費:百鍊 API Key
- Coding Plan:Coding Plan API Key
- 2
配置模型
開啟 Cherry Studio,點選右上角的設定按鈕,在 模型 欄點選 新增,填寫供應商名稱(例如
百鍊),提供商型別選擇 OpenAI。按計費方案填寫配置:Token Plan
配置項 值 API 地址 https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1API 金鑰 Token Plan 個人版或團隊版專屬 API Key 模型 填寫個人版或團隊版支援的文字生成模型 按量計費
按實際呼叫量後付費。將
{WorkspaceId}替換為 Workspace ID,以下以新加坡為例。配置項 值 API 地址 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1API 金鑰 百鍊 API Key 模型 qwen3.8-max或qwen3.8-flash;可用模型見 OpenAI 相容介面支援的模型Coding Plan
配置項 值 API 地址 https://coding-intl.dashscope.aliyuncs.com/v1API 金鑰 Coding Plan 專屬 API Key 模型 qwen3.7-plus;可用模型見 Coding Plan 支援的模型 - 3
驗證
在 模型 ID 填入模型,點選 新增。返回對話介面,選擇剛新增的模型併傳送任意訊息,模型正常返回響應即配置成功。
錯誤碼
配置過程中遇到報錯,參考對應計費方案的常見問題文件:
- Token Plan:個人版常見問題 · 團隊版常見問題
- 按量計費:錯誤代碼
- Coding Plan:Coding Plan 常見問題
常見問題
如何按量計費接入節省計劃?
按量計費接入方式不變,使用百煉通用 API Key 和 Base URL。購買節省計劃後自動生效,呼叫費用按抵扣順序自動抵扣。詳情參見節省計劃。
呼叫時報錯 401 Unauthorized
可能原因:
- API Key 與所選計費方案不匹配。Token Plan、按量計費和 Coding Plan 的 API Key 互不通用。
- 按量計費的 API Key 與 API 地址不在同一地域。
使用對應方案的專屬 API Key,並確認按量計費的 API Key 與地域匹配。
RAM 子賬號呼叫模型時報錯無許可權
RAM 子賬號需要擁有模型的呼叫許可權。參見業務空間管理。
報錯 The value of the enable_thinking parameter is restricted to True
原因:該模型僅支援在思考模式下執行,但呼叫時未開啟思考模式。
解決方案:在客戶端中開啟思考模式。
接入按量計費時,有免費額度但產生了費用
可能的原因:
- 地域不匹配:免費額度僅適用於新加坡地域的模型。使用其他地域的模型會產生費用。請檢查API 地址是否與目標地域匹配,詳情請參見新人免費額度。
- 額度按模型獨立計算:各模型的免費額度相互獨立,不可跨模型共享。
- 資料更新延遲:控制檯顯示的免費額度資料每小時更新。即使控制檯顯示仍有餘量,實際額度也可能已耗盡。
可透過如何檢視產生費用的模型?及如何檢視模型呼叫記錄?確認費用詳情。