401, auth error code: invalid_api_key

2026年06月16日 14:01 processing

错误信息

unexpected status 401 Unauthorized: Incorrect API key provided: sk-xvYV9***************************************gbft. You can find your API key at https://platform.openai.com/account/api-keys., url: https://api.openai.com/v1/responses, cf-ray: a0c78ba2adf5e10a-SIN, request id: req_bfdabb6a9e5e446a94ea30099e641798, auth error: 401, auth error code: invalid_api_key

AI 解决方案

🔧 报错分析:OpenAI API 认证失败

1. 🌐 错误翻译


原文:unexpected status 401 Unauthorized: Incorrect API key provided: sk-xvYV9***************************************gbft.
译文:意外状态 401 未授权:提供了错误的API密钥:sk-xvYV9***************************************gbft。

2. 🎯 原因分析


  • 根本原因:您的代码向OpenAI API发送请求时,所使用的API密钥 (sk-...gbft) 无法通过服务器的身份验证。

  • 具体分析:错误信息明确指出 Incorrect API key provided(提供了错误的API密钥)。这通常由以下几种情况导致:

  • 1. API密钥本身不正确:密钥在复制时截断、包含多余的空格或换行符,或者已被撤销/过期。
    2. 环境变量未正确设置:代码中通过环境变量(如 OPENAI_API_KEY)读取密钥,但该变量未在运行环境中正确设置。
    3. 代码硬编码了错误的值:将错误的密钥直接写入了代码中。
    4. 配置了错误的API地址:虽然此错误主要指向密钥,但有时连接到错误的API端点(例如代理或本地端点)也可能返回类似认证错误。

    3. 💡 解决方案


    请按以下步骤检查和修复:

    步骤1:获取并验证正确的API密钥

  • 登录 [OpenAI API 密钥管理页面](https://platform.openai.com/api-keys)。

  • 复制一个有效且未过期的密钥。注意: 仅复制以 sk- 开头的完整字符串,不要包含额外的引号或空格。
  • 步骤2:在代码中正确配置密钥

  • 推荐方法:使用环境变量

  • 在您的终端或应用配置中设置环境变量:
        # Linux/macOS
        export OPENAI_API_KEY='sk-你的新密钥'
    
        # Windows (PowerShell)
        $env:OPENAI_API_KEY='sk-你的新密钥'
        

    然后在代码中通过