中文实用指南 · 独立指南

DeepSeek Harness 模型配置:提供商、协议与模型 ID

先进入本地 Web UI 的 Settings → Models,选定提供商并保存所需凭据,再在会话中选择具体模型。接第三方网关时,还要核对它接受的 Base URL、协议和模型 ID。模型出现在选择器里、配置保存成功、推理请求成功是三项不同检查;完成前两项后,仍应在新会话执行一个能人工核对的小任务。

核验 2026年10月4日开发预览版独立指南
资料状态: 依据下方固定版本官方资料整理;发布元数据和历史运行实测分别标注。 新版本发布后请重新核对官方资料。
保存设置进度 →

分享仅包含公开链接,不携带本地进度或私人配置。

先选择内置提供商或自定义网关

内置提供商的模型目录来自已安装的包;自定义模型 API 面向中转服务、公司网关和自托管端点。只更改内置提供商的地址,不会让它的模型目录变成网关实时返回的列表。

  1. 使用提供商正式文档里的地址,不从其他教程猜测路径。
  2. 需要查询网关模型时,在 Custom model API 中使用发现功能。
  3. 从一个模型开始,成功后再添加其他模型。

把协议、Provider ID 与模型 ID 分开核对

提供商 ID 用于请求路由、会话和凭据引用;显示名称只用于界面。模型 ID 必须与端点实际接受的标识一致。OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 是不同协议,同一网关支持多个协议时分别建立配置。

  1. 保留稳定的小写 Provider ID。
  2. 不要把展示名称复制成请求模型 ID。
  3. 先确认协议,再调整可选图片或推理设置。

保存凭据后新建会话

按本地界面要求保存提供商,再选择模型。修改默认模型影响新会话,已经发送过请求的会话可能保留原来的模型记录。首次验证使用新会话,检查界面显示的提供商与模型,再请求总结仓库并指出一份具体文件。

  1. 官方 API key 与账号登录是不同凭据路径。
  2. 凭据只填入本地 DSH,不填入本站。
  3. 保存后无需仅为普通模型配置修改而重装整个启动器。

按失败发生的位置选择下一步

MISSING_CREDENTIAL 先检查当前路由的凭据来源;UNKNOWN_MODEL 先检查模型是否在该路由配置中;发现为空时可依据端点文档手动填 ID。模型存在但请求格式被拒绝,再检查协议和网关兼容设置。

常见问题

模型发现为空,是否说明这个网关不能用?

不能直接这样判断。发现和推理是两种请求;端点可能支持推理但不支持当前列表格式。使用它正式公布的模型 ID 手动添加,然后分别验证推理。

改了默认模型,旧会话会自动切换吗?

不要据此判断。已经发过请求的会话会保留自己的模型记录。新建会话并检查选择器,才能清楚验证保存后的配置。

API key 保存后不显示原文,是不是没有保存?

官方模型界面采用只写凭据,保存后返回脱敏描述符,不回显完整密钥。应通过路由和最小请求验证,不把不回显当作保存失败。

官方资料

使用新版本前,打开以下固定版本或注明核验日期的资料。

下一步阅读