在 Cursor 中使用阿里雲百鍊模型。
快速開始
- 1
獲取 API Key
根據所選計費方案獲取 API Key:
- Token Plan 個人版:建立或查看 API Key
- Token Plan 團隊版:分配席位並取得 API Key
- 按量計費:百鍊 API Key
- Coding Plan:Coding Plan API Key
- 2
配置模型
在 Cursor 中開啟 Cursor Settings > Models,開啟 OpenAI API Key 和 Override OpenAI Base URL,按所選方案填寫。
Token Plan
配置項 值 Base URL https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1API Key Token Plan API Key 模型 填寫個人版或團隊版支援的文字生成模型;部分模型需要設定別名,見常見問題 按量計費
將
{WorkspaceId}替換為真實的 Workspace ID。配置項 值 Base URL https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1API Key 阿里雲百鍊 API Key 模型 例如 qwen3.8-max或qwen3.8-flashCoding Plan
配置項 值 Base URL https://coding-intl.dashscope.aliyuncs.com/v1API Key Coding Plan API Key 模型 填寫支援的文字生成模型 - 3
驗證
在 Cursor 聊天面板傳送一條訊息,模型正常返回響應即表示配置成功。
接入百鍊 CLI
百鍊 CLI 安裝時會向 ~/.cursor/skills/bailian-cli/ 註冊 Skill,Cursor 可以透過對話呼叫百鍊能力。能力清單見百鍊 CLI 控制檯。前置要求 Node.js 18+。
- 1
安裝百鍊 CLI
在 Cursor 對話中執行:
请帮我全局安装阿里云百炼 CLI 命令行工具:npm install -g bailian-cli - 2
配置 API Key
獲取 API Key,然後在對話中讓 Cursor 配置該 API Key。
錯誤碼
配置過程中遇到報錯,參考對應計費方案的常見問題文件:
- Token Plan:個人版常見問題 · 團隊版常見問題
- 按量計費:錯誤代碼
- Coding Plan:Coding Plan 常見問題
常見問題
如何按量計費接入節省計劃?
按量計費接入方式不變,使用百煉通用 API Key 和 Base URL。購買節省計劃後自動生效,呼叫費用按抵扣順序自動抵扣。詳情參見節省計劃。
在 Cursor 中無法呼叫已新增的模型
報錯資訊如下:
- The model xxx does not work with your current plan or api key.
- Named models unavailable Free plans can only use Auto. Switch to Auto or upgrade plans to continue.
原因:Cursor 免費版僅支援 Auto 模式,不支援呼叫自定義模型。
解決方案:升級至 Cursor Pro 及以上套餐。
配置完成後找不到新增的模型
在聊天面板關閉 Auto 模式,在模型下拉欄選擇所需模型。
部分模型名稱無法呼叫
部分模型 ID 與 Cursor 內建模型名衝突,需要改寫為連字元形式:
- glm-5.3 寫為
glm-5-3,glm-5.2 寫為glm-5-2,glm-5.1 寫為glm-5-1,glm-5 寫為glm-5-0 - kimi-k2.6 寫為
kimi-k2-6,kimi-k2.5 寫為kimi-k2-5
各方案支援的模型不同,以對應支援列表為準。
呼叫模型報錯 "We're having trouble connecting to the model provider." 或 "Unauthorized User API key"
請逐項排查:
- API Key、Base URL 和模型名稱是否與所選計費方案一致。不同方案的憑證不通用。
- 按量計費的 API Key 是否與 Base URL 屬於同一地域。
- 模型名稱是否需要改寫,參見上一條。