API Key错误

一句话：API Key错误通常表现为认证失败、无权限、额度不足、环境变量未读取或Key填错。

它是什么

API Key是调用AI模型或第三方服务时的身份凭证。API Key错误不是模型不会回答，而是程序没有正确证明自己有权限调用服务。常见表现包括 401、403、invalid_api_key、unauthorized、quota exceeded。

适合干什么

• 接入OpenAI、Claude、DeepSeek、通义等API的人
• 本地运行AI项目但接口调用失败的人
• 部署后发现本地正常、线上失败的人
• 不清楚 .env 和环境变量的新手

不适合干什么

• 网页端ChatGPT登录失败的问题
• 模型回答质量不好但接口能正常返回的问题
• 网络完全不通导致的连接问题

普通人怎么用

• 确认Key是否复制完整
• 确认Key放在正确的环境变量名下
• 重启项目让 .env 生效
• 确认账号有额度和权限
• 不要把真实Key发给别人或提交到GitHub

进阶用户怎么用

• 区分认证失败、权限不足、额度不足和模型名错误
• 在部署平台单独配置环境变量
• 用最小测试脚本验证Key是否可用
• 泄露后立即吊销旧Key并生成新Key

常见误区

• 变量名写错，如 OPENAI_APIKEY 少了下划线
• 修改 .env 后没有重启服务
• 把服务端Key写进前端代码
• 本地配置了Key，但部署平台没有配置

和相似工具的区别

• 401 vs 403：401通常是身份认证失败，403通常是有身份但没有权限。具体仍要看服务商报错文本。
• Key错误 vs 额度不足：Key错误是凭证无效或没读到，额度不足是凭证有效但账号余额、配额或权限不够。

入门步骤

• 不要暴露真实Key
• 检查环境变量名
• 检查服务端是否读取到变量
• 检查账户额度和模型权限
• 用最小请求验证

推荐工具（第三方）

OpenAI Dashboard、Anthropic Console、Vercel Environment Variables、dotenv、Postman