全部產品
Search
文件中心

Alibaba Cloud Model Studio:Cherry Studio

更新時間:Nov 05, 2026

在 Cherry Studio 中使用阿里雲百鍊模型。

快速開始

  1. 1

    獲取 API Key

    根據計費方案獲取對應的 API Key:

  2. 2

    配置模型

    開啟 Cherry Studio,點選右上角的設定按鈕,在 模型 欄點選 新增,填寫供應商名稱(例如 百鍊),提供商型別選擇 OpenAI。按計費方案填寫配置:

    Token Plan

    配置項值
    API 地址https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    API 金鑰Token Plan 個人版或團隊版專屬 API Key
    模型填寫個人版或團隊版支援的文字生成模型

    按量計費

    按實際呼叫量後付費。將 {WorkspaceId} 替換為 Workspace ID,以下以新加坡為例。

    配置項值
    API 地址https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    API 金鑰百鍊 API Key
    模型qwen3.8-max 或 qwen3.8-flash;可用模型見 OpenAI 相容介面支援的模型

    Coding Plan

    配置項值
    API 地址https://coding-intl.dashscope.aliyuncs.com/v1
    API 金鑰Coding Plan 專屬 API Key
    模型qwen3.7-plus;可用模型見 Coding Plan 支援的模型
  3. 3

    驗證

    在 模型 ID 填入模型,點選 新增。返回對話介面,選擇剛新增的模型併傳送任意訊息,模型正常返回響應即配置成功。

錯誤碼

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

常見問題

如何按量計費接入節省計劃?

按量計費接入方式不變,使用百煉通用 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 地址是否與目標地域匹配,詳情請參見新人免費額度。
  • 額度按模型獨立計算:各模型的免費額度相互獨立,不可跨模型共享。
  • 資料更新延遲:控制檯顯示的免費額度資料每小時更新。即使控制檯顯示仍有餘量,實際額度也可能已耗盡。

可透過如何檢視產生費用的模型?及如何檢視模型呼叫記錄?確認費用詳情。