DeepSeek Harness-大模型服务平台百炼(Model Studio)-阿里云帮助中心

在 DeepSeek Harness 中使用阿里云百炼模型。

快速开始

1
启动 Web UI
运行以下命令启动 DeepSeek Harness Web UI：
```
dsh web
```
默认地址为 http://127.0.0.1:3080，本机启动时会自动打开浏览器。
2
获取 API Key
根据计费方案获取对应的 API Key：
- Token Plan 个人版：创建或查看 API Key
- Token Plan 团队版：分配坐席并获取 API Key
- 按量计费：百炼 API Key
- Coding Plan：Coding Plan API Key

配置模型

在 Web UI 中进入 设置 → 模型，点击 添加模型提供商，切换到 自定义模型 API。DeepSeek Harness 未内置百炼提供商，Provider ID 可自定义（小写），下表以 bailian-tpp、bailian、bailian-coding 为例：

Token Plan

配置项	值
Provider ID	`bailian-tpp`
显示名称	Alibaba Cloud Model Studio
基础 URL	`https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
API 协议	OpenAI Chat Completions
API 密钥	上一步获取的 Token Plan API Key
模型	填写个人版或团队版支持的文本生成模型

按量计费

配置项	值
Provider ID	`bailian`
显示名称	Alibaba Cloud Model Studio
基础 URL	`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`，`{WorkspaceId}` 替换为 Workspace ID
API 协议	OpenAI Chat Completions
API 密钥	上一步获取的百炼 API Key
模型	例如 `qwen3.8-max`、`qwen3.8-flash`

Coding Plan

配置项	值
Provider ID	`bailian-coding`
显示名称	Alibaba Cloud Model Studio
基础 URL	`https://coding.dashscope.aliyuncs.com/v1`
API 协议	OpenAI Chat Completions
API 密钥	上一步获取的 Coding Plan API Key
模型	填写支持的文本生成模型

保存后，在 Web UI 的模型选择器中选择已添加的模型。

4
验证
在 Web UI 中发送一条消息，模型正常返回响应即表示配置成功。

通过配置文件接入

除了上述方式，也可以通过配置文件接入。

1
打开或新建配置文件
~/.dsh/profiles/web/cordis.patch.yml

写入配置

按计费方案添加以下配置。只添加对应条目，不要覆盖已有配置。启动前设置 BAILIAN_API_KEY 环境变量：

export BAILIAN_API_KEY="YOUR_API_KEY"

Token Plan 个人版

- id: llm-pi-ai
  config:
    providers:
      bailian-tpp:
        apiKeyEnv: BAILIAN_API_KEY
        api: openai-completions
        baseURL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
        models:
          - id: auto
          - id: qwen3.8-max
          - id: qwen3.8-flash
          - id: qwen3.7-max
          - id: qwen3.7-plus
          - id: qwen3.6-flash
          - id: deepseek-v4.1-flash
          - id: deepseek-v4.1-flash-1017
          - id: deepseek-v4-pro
          - id: deepseek-v4-pro-0813
          - id: deepseek-v4-flash-0731
          - id: glm-5.3
          - id: glm-5.2

Token Plan 团队版

- id: llm-pi-ai
  config:
    providers:
      bailian-tpp:
        apiKeyEnv: BAILIAN_API_KEY
        api: openai-completions
        baseURL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
        models:
          - id: auto
          - id: qwen3.8-max
          - id: qwen3.8-flash
          - id: qwen3.7-max
          - id: qwen3.7-plus
          - id: qwen3.6-plus
          - id: qwen3.6-flash
          - id: deepseek-v4.1-flash
          - id: deepseek-v4.1-flash-1017
          - id: deepseek-v4-pro
          - id: deepseek-v4-pro-0813
          - id: deepseek-v4-flash-0731
          - id: kimi-k2.7-code
          - id: kimi-k2.6
          - id: kimi-k2.5
          - id: glm-5.3
          - id: glm-5.2
          - id: glm-5.1
          - id: glm-5
          - id: MiniMax-M2.5

按量计费

将 {WorkspaceId} 替换为真实的 Workspace ID：

- id: llm-pi-ai
  config:
    providers:
      bailian:
        apiKeyEnv: BAILIAN_API_KEY
        api: openai-completions
        baseURL: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
        models:
          - id: qwen3.8-max
          - id: qwen3.7-plus
          - id: qwen3.8-flash
          - id: deepseek-v4-pro-0813
          - id: deepseek-v4.1-flash

Coding Plan

- id: llm-pi-ai
  config:
    providers:
      bailian-coding:
        apiKeyEnv: BAILIAN_API_KEY
        api: openai-completions
        baseURL: https://coding.dashscope.aliyuncs.com/v1
        models:
          - id: qwen3.7-plus
          - id: qwen3.6-plus
          - id: kimi-k2.5
          - id: glm-5
          - id: MiniMax-M2.5
          - id: qwen3.5-plus

保存后重启 DeepSeek Harness，在模型选择器中选择已添加的模型。

错误码

配置过程中遇到报错，参考对应计费方案的常见问题文档：

Token Plan：个人版常见问题 · 团队版常见问题
按量计费：错误码
Coding Plan：Coding Plan 常见问题

常见问题

如何按量计费接入节省计划与资源包？

按量计费接入方式不变，使用百炼通用 API Key 和 Base URL。购买节省计划或资源包后自动生效，调用费用按抵扣顺序自动抵扣。详情参见节省计划与资源包。

Fetch available models 返回 401

百炼 OpenAI 兼容端点不提供 GET /models 接口，点击 Fetch available models 会返回 401 或 404。该按钮可忽略，在模型目录中手动输入模型 ID 即可。

报错 MISSING_CREDENTIAL

在 Web UI 的 设置 → 模型 中重新输入 API Key 并保存；或确认环境变量 BAILIAN_API_KEY 已设置并重启 DeepSeek Harness。

配置后找不到已添加的模型

重启 DeepSeek Harness，再在 Web UI 的模型选择器中选择。新增模型时，在 设置 → 模型 中编辑该提供商，在模型目录中添加模型 ID 并保存；也可以编辑 cordis.patch.yml 的 models。