DeepSeek Harness 模型配置:提供商、协议与模型 ID
先进入本地 Web UI 的 Settings → Models,选定提供商并保存所需凭据,再在会话中选择具体模型。接第三方网关时,还要核对它接受的 Base URL、协议和模型 ID。模型出现在选择器里、配置保存成功、推理请求成功是三项不同检查;完成前两项后,仍应在新会话执行一个能人工核对的小任务。
分享仅包含公开链接,不携带本地进度或私人配置。
先选择内置提供商或自定义网关
内置提供商的模型目录来自已安装的包;自定义模型 API 面向中转服务、公司网关和自托管端点。只更改内置提供商的地址,不会让它的模型目录变成网关实时返回的列表。
- 使用提供商正式文档里的地址,不从其他教程猜测路径。
- 需要查询网关模型时,在 Custom model API 中使用发现功能。
- 从一个模型开始,成功后再添加其他模型。
把协议、Provider ID 与模型 ID 分开核对
提供商 ID 用于请求路由、会话和凭据引用;显示名称只用于界面。模型 ID 必须与端点实际接受的标识一致。OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 是不同协议,同一网关支持多个协议时分别建立配置。
- 保留稳定的小写 Provider ID。
- 不要把展示名称复制成请求模型 ID。
- 先确认协议,再调整可选图片或推理设置。
保存凭据后新建会话
按本地界面要求保存提供商,再选择模型。修改默认模型影响新会话,已经发送过请求的会话可能保留原来的模型记录。首次验证使用新会话,检查界面显示的提供商与模型,再请求总结仓库并指出一份具体文件。
- 官方 API key 与账号登录是不同凭据路径。
- 凭据只填入本地 DSH,不填入本站。
- 保存后无需仅为普通模型配置修改而重装整个启动器。
按失败发生的位置选择下一步
MISSING_CREDENTIAL 先检查当前路由的凭据来源;UNKNOWN_MODEL 先检查模型是否在该路由配置中;发现为空时可依据端点文档手动填 ID。模型存在但请求格式被拒绝,再检查协议和网关兼容设置。
常见问题
模型发现为空,是否说明这个网关不能用?
不能直接这样判断。发现和推理是两种请求;端点可能支持推理但不支持当前列表格式。使用它正式公布的模型 ID 手动添加,然后分别验证推理。
改了默认模型,旧会话会自动切换吗?
不要据此判断。已经发过请求的会话会保留自己的模型记录。新建会话并检查选择器,才能清楚验证保存后的配置。
API key 保存后不显示原文,是不是没有保存?
官方模型界面采用只写凭据,保存后返回脱敏描述符,不回显完整密钥。应通过路由和最小请求验证,不把不回显当作保存失败。
官方资料
使用新版本前,打开以下固定版本或注明核验日期的资料。