报错解决 错误码 invalid_api_key 相关服务:OpenAI

解决 OpenAI API invalid_api_key 密钥无效错误

遇到 invalid_api_key 或 incorrect_api_key_provided 错误?教你排查 Key 是否有效、是否过期、以及正确使用 Bearer 认证。

常见症状: invalid_api_keyIncorrect API key providedAPI key 无效Key 验证失败

一句话回答

invalid_api_key 表示服务端无法识别你提供的 API Key。Key 可能已过期、被删除、复制不完整,或认证头格式错误。

常见原因和解决方案

1. Key 复制不完整

症状:刚从后台复制的 Key,配置后立即报错

检查方法

  • Key 通常以 sk- 开头
  • 确认复制内容完整,没有多余空格或换行符
  • 重新从后台复制,粘贴到纯文本编辑器确认内容完整性

2. Key 已过期或被删除

症状:之前能用,突然失效

检查方法

  • 登录后台查看 Key 状态
  • 检查是否误操作删除了正在使用的 Key
  • 确认 Key 没有设置有效期且已过期

解决:在后台重新生成一个新的 API Key,并更新到所有工具中。

3. 认证头格式错误

如果用代码直接调用,确认 Authorization 头格式:

# 正确
headers = {
    "Authorization": "Bearer sk-your-api-key-here"
}

# 错误 - 缺少 Bearer
headers = {
    "Authorization": "sk-your-api-key-here"
}

# 错误 - Bearer 后缺少空格
headers = {
    "Authorization": "Bearersk-your-api-key-here"
}

4. Key 与 API 地址不匹配

不同服务的 API Key 不能互通。确认:

  • 在 TokenCheap 后台生成的 Key,应该配 TokenCheap 的 API 地址
  • 不要混用不同服务商的 Key 和地址

快速排查清单

  1. 重新从后台完整复制 Key
  2. 检查 Key 前后是否有空格或换行符
  3. 确认 Key 未过期、未被删除
  4. 检查 Authorization 头格式(Bearer + 空格 + Key)
  5. 确认 Key 和 API 地址来自同一服务
  6. 用 curl 单独测试 Key 是否正常

测试 Key 是否有效

curl https://api.tokencheap.space/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果返回模型列表,说明 Key 有效;返回 401,说明 Key 确实有问题。

相关教程