密钥配置与错误排查 — 401、无效、长度检查四步

四种典型错误

密钥相关的高频报错有四种：

401 认证错误

请求发出去但供应商拒绝了。典型原因：

1. 拼写错误——多打了空格、复制了引号、漏了前缀（比如 DeepSeek 密钥前缀是 sk-）
2. 密钥过期或被吊销——供应商后台已经撤销了这个密钥
3. 供应商不匹配——把阿里 DashScope 的密钥填给了 OpenAI，或者把 OpenAI 的填给了 DeepSeek
4. 账户权限不足——OpenAI 新账户的密钥默认只有组织内某些项目能用

429 请求限制 / 超出配额

请求频率超过了供应商限制，或者免费额度用完了：

1. 减少并发调用——短时间内不要猛刷指令
2. 检查账户配额——免费版有额度限制，用完了要么升级要么等重置
3. 多人共享密钥——如果是团队共用，协调使用频率

密钥格式验证

七匣子教程里提到了一个实用检查：

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

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

软件缓存残留

有时候密钥改对了还报错，试试：

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

排查四步法

1. 确认供应商和密钥匹配——OpenAI 密钥填 OpenAI 槽、DeepSeek 密钥填 DeepSeek 槽，别搞混
2. 检查密钥长度——DeepSeek ≥35、Qwen ≥20，不够就是复制坏了
3. 回供应商后台验证——用 Postman 或 curl 直接发一个测试请求
4. 清缓存重填——还是不行就清缓存、关掉守护进程、重新配置

安全提示

• 密钥保存在手机本地加密存储，不会上传到 ZeroAI 服务器（它没有服务器）
• 不要把密钥截图、不要在公共场合调试密钥
• 供应商后台开启密钥权限控制——只给需要的模型访问权限

资料来源：七匣子 zeroai FAQ