DeepSeek Harness 模型供应商怎么接：官方、第三方网关与自定义端点的完整配置步骤

模型供应商分三类：官方、第三方网关、自定义端点。 三类都能接，但鉴权、模型列表与错误码不同；按类型配，排查才快。

三类供应商

先看差异，再选一条。

官方最省事。 字段少、模型列表稳定，适合大多数日常使用（来源）。

网关多一层转发。 它能统一鉴权或计费，但协议与模型列表取决于网关实现；配之前先看文档。

自定义端点最灵活，也最容易填错。 base URL、协议与模型名都要自己对齐；路径多一段或少一段都会 404。

官方提供方：先跑通最小配置

官方配置的关键是「密钥有效、模型正确」。

1. 获取 API Key，确认额度与权限。
2. 在模型设置里选择官方提供方。
3. 填入密钥，选择目标模型。
4. 保存后发一条测试消息。
5. 确认请求成功，再调参数。

先不要改高级参数，密钥与模型也要匹配。 温度、输出上限等先保持默认；最小请求通过，再逐步调整。有权限的密钥配上无权限的模型，会表现为鉴权失败或模型不存在。

第三方网关：先确认协议

网关的差异在协议与模型列表。

1. 确认网关支持 OpenAI 兼容还是自有协议。
2. 填网关地址与密钥，注意是否需要额外请求头。
3. 测试模型列表；拉不到就手填模型名。
4. 发一条消息，确认转发链路正常。
5. 记录网关版本与配置，便于排查。

网关可能改写错误码。 上游 401 到网关可能变成 500；排查时看网关日志，不要只看客户端提示。

网关的模型名可能被重命名。 它用自己的别名映射上游模型；填错别名，表现为模型不存在。

自定义端点：地址与路径

自定义端点最容易在 base URL 上出错。

1. 确认协议：OpenAI 兼容还是其他。
2. 填 base URL：是否带 /v1、是否带版本段，按服务方文档。
3. 填模型名：大小写与后缀逐字对。
4. 如需要，填额外请求头与超时。
5. 保存后先测列表，再测对话。

路径多一段就 404。 有的服务要求 /v1，有的不要；照文档抄，不要凭经验。

模型名不是显示名。 界面上看到的名字可能是别名；配置里要填服务方文档里的标识。

配置字段与顺序

按「身份 → 地址 → 模型 → 参数」顺序填。

1. Provider ID： 用能区分的名字，例如 official、gateway-a。
2. base URL： 官方可留默认，网关与自定义必填。
3. 密钥： 与地址属于同一服务，不要混搭。
4. 模型： 先自动发现，失败再手填。
5. 参数： 最后调，避免把配置问题与参数问题混在一起。

顺序的意义是逐层验证。 身份不对，后面都白填；地址不对，模型列表拉不到；模型不对，请求失败。

一次只配一组。 同时加多个供应商，出错时分不清是哪一组。

连通测试

三步测试，逐层确认。

1. 列表测试： 能拉到模型列表，说明地址与鉴权基本正确。
2. 对话测试： 发一条短消息，能收到回复，说明链路完整。
3. 日志测试： 请求指向预期地址与模型，没有重试或回退。

列表失败不一定是密钥问题。 404 偏地址，401 偏鉴权；先看状态码，再改配置。

对话失败要看完整错误。 客户端提示可能被包装；日志里的上游错误更具体。

失败排查

四类失败覆盖大多数供应商配置。

1. 401/403： 密钥错误、过期或无权限；核对密钥与端点。
2. 404： base URL 或模型名错误；核对文档与路径。
3. 超时： 网络、代理或网关转发慢；先测连通性。
4. 能列表不能对话： 协议或模型权限问题；看请求体与日志。

四类的排查入口是「状态码 + 日志 + 文档」。 状态码定层，日志看细节，文档对字段。

先回退到上一个可用配置。 改坏后不要连续试；回到已知可用，再一次改一处。

下一步

先选类型，再按顺序填，最后三步测试。 想看本地模型，看《DeepSeek Harness 接本地模型》；想看两类报错，看《API 密钥无效与模型发现 404》；想看代理配置，看《DeepSeek Harness 代理怎么配》。

来源：DeepSeek Harness 官方文档、dsh CLI README、DeepSeek 官方 API 文档