401 认证错误 — 密钥无效排查四步

错误表现

调用模型时报：

• 401 Unauthorized
• Invalid API key
• 密钥无效

四步排查

1. 确认供应商和密钥匹配

这是最常见的问题——把阿里 DashScope 的密钥填给了 OpenAI，或者把 OpenAI 的填给了 DeepSeek。

正确姿势：OpenAI 密钥填 OpenAI 槽、DeepSeek 密钥填 DeepSeek 槽，别搞混。

2. 检查密钥长度

七匣子 FAQ 里的实用检查：

• DeepSeek 密钥：至少 35 字符
• Qwen（阿里云 DashScope）密钥：至少 20 字符

如果长度不够，大概率是复制坏了——回去供应商后台重新生成。

3. 回供应商后台验证

用 curl 或 Postman 直接发一个测试请求，确认密钥本身没问题：

# 测试 DeepSeek 密钥
curl DeepSeek API 端点/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

返回模型列表 = 密钥有效；返回 401 = 密钥被吊销/过期/复制错了。

4. 清缓存重填

密钥改对了还报错的最后手段：

1. 打开 ZeroAI 设置
2. 清除应用缓存
3. 关掉守护进程
4. 重新进入 API 设置界面，重新配置并保存

其他可能原因

• 账户权限不足——OpenAI 新账户的密钥默认只有组织内某些项目能用
• Qwen 区域不匹配——中国区密钥填国际区端点会 401
• 密钥有前缀——DeepSeek 密钥前缀是 sk-，复制时漏了也会 401

资料来源：七匣子 zeroai FAQ