401 Authentication Failed
修复 401 authentication failed：核对 API Key、Base URL 和环境变量凭据，并把模型发现与聊天请求分开测试。
本页内容
先确认是不是 401 authentication failed
这页只处理 401 authentication failed 这一类报错。不同系统或 Node.js 版本可能多几个单词，但核心错误码或句式应该一致。
401 authentication failed401 Unauthorizedauthentication failed 401DSH 401 error401 / authentication failed搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。
401 表示远端模型服务商拒绝了当前请求的认证。重新填写正确 Key，核对 Base URL；如果凭据来自环境变量，请从已设置该变量的终端重新启动 DSH。只有“获取可用模型”失败时，要与聊天请求分开排查。
401 authentication failed 是什么意思
远端服务拒绝了当前请求的认证。这并不代表问题一定只在 Key，也可能是 Endpoint、账号信息或认证方式不匹配。
401 authentication failed 的常见原因
- Key 无效、过期、被撤销，或复制时带入了首尾空格。
- Key 属于另一个模型服务商或 Base URL。
- DSH 在 apiKeyEnv 设置或更新前就已经启动。
- 该模型服务商还需要项目、区域、OAuth 等额外认证信息。
- 自定义网关对 GET /models 和聊天接口采用不同认证规则。
401 authentication failed 的源码依据
下面链接固定到本页核验使用的 0.1.2-alpha.5 / 49a606b。先确认 401 authentication failed 是 DSH 自身行为，还是 Node.js、PowerShell、操作系统网络或文件权限产生的错误。
修复 401 authentication failed
- 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。
确认 401 authentication failed 已经修好
- 模型服务商可以完成一个简单纯文本请求。
- 模型发现成功，或使用已确认的手动 Model ID 后聊天可以正常工作。
- 求助时不要公开真实 Key。
- 不要关闭 TLS 证书校验来掩盖认证错误。
- 不要反复修改无关的工作区或端口设置。
401 authentication failed 常见问题
401 authentication failed 怎么修？
401 表示远端模型服务商拒绝了当前请求的认证。重新填写正确 Key，核对 Base URL；如果凭据来自环境变量，请从已设置该变量的终端重新启动 DSH。只有“获取可用模型”失败时，要与聊天请求分开排查。
401 authentication failed 是什么意思？
远端服务拒绝了当前请求的认证。这并不代表问题一定只在 Key，也可能是 Endpoint、账号信息或认证方式不匹配。
怎么确认 401 authentication failed 已经修好？
模型服务商可以完成一个简单纯文本请求。 模型发现成功，或使用已确认的手动 Model ID 后聊天可以正常工作。
本页于 2026-09-03 对照官方仓库核验。网站使用的已发布版本基线为 0.1.1-rc.2；源码核验快照为 0.1.2-alpha.5（49a606b）。