在 VS Code 中使用阿里雲百煉模型。
快速開始
- 1
取得 API Key
依據計費方案取得 API Key:
- Token Plan:Token Plan API Key
- 按量計費:百煉 API Key
- Coding Plan:Coding Plan API Key
- 2
開啟模型管理
在 VS Code 中執行
Chat: Manage Language Models,選擇 Add Models > Custom Endpoint,協定選擇 Chat Completions。 - 3
填寫連線資訊
依嚮導填寫群組名稱、顯示名稱與所選方案的 API Key。嚮導會為
apiKey產生安全輸入參照,請勿寫入明文 API Key。 - 4
選擇模型
依計費方案填寫連線位址與模型:
Token Plan
按量計費
將
{WorkspaceId}取代為實際的 Workspace ID。- Base URL:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - 完整
url:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions - 模型:例如
qwen3.8-max或qwen3.8-flash
Coding Plan
- Base URL:
https://coding-intl.dashscope.aliyuncs.com/v1 - 完整
url:https://coding-intl.dashscope.aliyuncs.com/v1/chat/completions - 模型:例如
qwen3.7-plus
- Base URL:
- 5
設定模型參數
在
chatLanguageModels.json中設定以下欄位:vendor:customendpointapiType:chat-completionsmodels[].id:上一步的模型 IDmodels[].name:自訂顯示名稱models[].url:上一步的完整urlmodels[].toolCalling、vision、maxInputTokens、maxOutputTokens:依模型規格填寫
先確認方案支援該模型,再查閱模型清單;輸入與輸出 Token 數總和不超過模型上下文長度。欄位說明請參閱 VS Code 官方文件。
- 6
驗證
在 Chat 的模型選取器中選擇已設定的模型,傳送「你好」。收到回覆即表示串接成功。
常見問題
如何按量計費接入節省計劃?
按量計費接入方式不變,使用百煉通用 API Key 和 Base URL。購買節省計劃後自動生效,呼叫費用按抵扣順序自動抵扣。詳情參見節省計劃。
模型未出現在 VS Code Chat 的模型選擇器中
儲存 chatLanguageModels.json 後重新啟動 VS Code,再檢查模型選擇器。
無法呼叫模型或傳回 401
確認 API Key、Base URL 和模型屬於同一方案。Token Plan、Coding Plan 與按量計費的 API Key 互不通用。按量計費還需確認 {WorkspaceId} 已取代為正確地域的 Workspace ID。
組織原則限制 BYOK
聯絡 Copilot Business / Enterprise 管理員,確認 Bring Your Own Language Model Key in VS Code 原則。