OpenAI 401 Invalid API Key 解决方法

OpenAI API 返回 401 Unauthorized 或 Invalid API Key 错误？本文帮你排查认证问题。

常见原因

1. API Key 无效

• Key 已被撤销或过期
• 复制 Key 时遗漏了字符
• 使用了错误的 Key（如组织 Key 当项目 Key 用）

2. Key 格式错误

# OpenAI 官方 Key 格式
sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 常见错误
Bearer sk-proj-xxx  # 不需要 "Bearer" 前缀
"sk-proj-xxx"       # 不需要引号
sk-proj-xxx\n       # 末尾有换行符

3. 请求头设置错误

# 正确的请求头
Authorization: Bearer sk-proj-xxxxx

# 错误示例
Authorization: sk-proj-xxxxx           # 缺少 "Bearer" 前缀
X-API-Key: sk-proj-xxxxx               # 用了错误的头名
authorization: Bearer sk-proj-xxxxx    # 大小写通常不影响，但要注意

4. 使用了错误的端点

中转站的 API Key 不能直接用在 OpenAI 官方端点，反之亦然。确保 Key 和 Base URL 匹配：

• OpenAI 官方 Key → https://api.openai.com/v1
• 中转站 Key → 中转站提供的 Base URL

排查步骤

步骤 1：验证 Key

# 用 curl 测试
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer your-api-key"

# 如果返回模型列表，Key 有效
# 如果返回 401，Key 无效

步骤 2：检查环境变量

# 查看当前设置的 Key（注意脱敏）
echo $OPENAI_API_KEY | head -c 20

步骤 3：重新生成 Key

如果 Key 确认无效，在 OpenAI 平台或中转站重新生成一个。

使用中转站避免认证问题