Skip to main content

VS Code

在 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
    • 按量计费
    • 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。购买节省计划或资源包后自动生效,调用费用按抵扣顺序自动抵扣。详情参见节省计划与资源包。
保存 chatLanguageModels.json 后重启 VS Code,再检查模型选择器。
确认 API Key、Base URL 和模型属于同一方案。Token Plan、Coding Plan 与按量计费的 API Key 互不通用。按量计费还需确认 {WorkspaceId} 已替换为正确地域的 Workspace ID。
联系 Copilot Business / Enterprise 管理员确认 Bring Your Own Language Model Key in VS Code 策略。