全部產品
Search
文件中心

Alibaba Cloud Model Studio:VS Code

更新時間:Nov 05, 2026

在 VS Code 中使用阿里雲百煉模型。

快速開始

  1. 1

    取得 API Key

    依據計費方案取得 API Key:

  2. 2

    開啟模型管理

    在 VS Code 中執行 Chat: Manage Language Models,選擇 Add Models > Custom Endpoint,協定選擇 Chat Completions。

  3. 3

    填寫連線資訊

    依嚮導填寫群組名稱、顯示名稱與所選方案的 API Key。嚮導會為 apiKey 產生安全輸入參照,請勿寫入明文 API Key。

  4. 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

  5. 5

    設定模型參數

    在 chatLanguageModels.json 中設定以下欄位:

    • vendor:customendpoint
    • apiType:chat-completions
    • models[].id:上一步的模型 ID
    • models[].name:自訂顯示名稱
    • models[].url:上一步的完整 url
    • models[].toolCalling、vision、maxInputTokens、maxOutputTokens:依模型規格填寫

    先確認方案支援該模型,再查閱模型清單;輸入與輸出 Token 數總和不超過模型上下文長度。欄位說明請參閱 VS Code 官方文件。

  6. 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 原則。