401 Authentication Failed
修复 401 authentication failed：核对 API Key、Base URL 和环境变量凭据，并把模型发现与聊天请求分开测试。
本页内容
核对错误信息
在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。
401 authentication failed401 Unauthorizedauthentication failed 401DSH 401 error401 / authentication failed搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。
401 表示远端模型服务商拒绝了当前请求的认证。重新填写正确 Key，核对 Base URL；如果凭据来自环境变量，请从已设置该变量的终端重新启动 DSH。只有“获取可用模型”失败时，要与聊天请求分开排查。
错误含义
远端服务拒绝了当前请求的认证。这并不代表问题一定只在 Key，也可能是 Endpoint、账号信息或认证方式不匹配。
常见原因
- Key 无效、过期、被撤销，或复制时带入了首尾空格。
- Key 属于另一个模型服务商或 Base URL。
- DSH 在 apiKeyEnv 设置或更新前就已经启动。
- 该模型服务商还需要项目、区域、OAuth 等额外认证信息。
- 自定义网关对 GET /models 和聊天接口采用不同认证规则。
对应文档与源码
DSH 相关链接固定到 0.1.5-rc.2 / c291e79；涉及系统和运行环境的说明见对应官方文档。
修复步骤
- 01
重新填写 Key
从模型服务商控制台重新复制 Key，替换已保存凭据，并确认没有首尾空格。
- 02
核对 Base URL
确认 Key 属于当前配置的 Endpoint。DeepSeek Key 不能用于无关的 OpenAI 兼容网关。
- 03
使用 apiKeyEnv 时重新启动
如果凭据来自 apiKeyEnv，先设置环境变量，再从同一个终端重新启动 DSH。
- 04
把“获取模型”和聊天分开测试
如果聊天可用但“获取可用模型”返回 401，可以先手动添加已确认的 Model ID，再单独排查网关 GET /models 的认证。
- 05
检查服务商自己的认证要求
Bedrock、Vertex、Azure、Codex 等原生服务商可能不只需要一个 API Key，还要按各自要求配置项目、区域或 OAuth。
检查结果
- 模型服务商可以完成一个简单纯文本请求。
- 模型发现成功，或使用已确认的手动 Model ID 后聊天可以正常工作。
- 求助时不要公开真实 Key。
- 不要关闭 TLS 证书校验来掩盖认证错误。
- 不要反复修改无关的工作区或端口设置。
常见问题速查
401 authentication failed 怎么修？
401 表示远端模型服务商拒绝了当前请求的认证。重新填写正确 Key，核对 Base URL；如果凭据来自环境变量，请从已设置该变量的终端重新启动 DSH。只有“获取可用模型”失败时，要与聊天请求分开排查。
401 authentication failed 是什么意思？
远端服务拒绝了当前请求的认证。这并不代表问题一定只在 Key，也可能是 Endpoint、账号信息或认证方式不匹配。
怎么确认 401 authentication failed 已经修好？
模型服务商可以完成一个简单纯文本请求。 模型发现成功，或使用已确认的手动 Model ID 后聊天可以正常工作。
本页于 2026-09-11 对照官方仓库核验。网站使用的已发布版本基线为 0.1.5-rc.1；源码核验快照为 0.1.5-rc.2（c291e79）。