Discord机器人调用OpenAI API遇双重错误：认证及端点不兼容

一、openai.error.AuthenticationError（未提供API密钥） #

问题原因 #

代码通过os.environ.get("OPENAI_API_KEY")读取环境变量，但系统未正确设置该变量、变量名拼写错误，或者环境变量未成功加载，导致OpenAI库无法获取有效密钥。

解决办法 #

• 正确设置环境变量
  • Linux/macOS终端临时设置：export OPENAI_API_KEY="你的API密钥"
  • Windows命令行临时设置：set OPENAI_API_KEY=你的API密钥
  • 持久化管理（推荐）：使用.env文件配合python-dotenv库，步骤如下：
    1. 安装库：pip install python-dotenv
    2. 创建.env文件，写入OPENAI_API_KEY=你的API密钥
    3. 代码开头添加加载逻辑：

       from dotenv import load_dotenv
       load_dotenv()
       

• 添加密钥校验
  在设置API密钥后增加判断，提前暴露问题：

  openai.api_key = os.environ.get("OPENAI_API_KEY")
  if not openai.api_key:
      raise ValueError("未检测到OPENAI_API_KEY环境变量，请正确设置")
  

• 临时测试方案
  开发阶段可直接硬编码密钥（注意不要提交到代码仓库）：

  openai.api_key = "你的实际API密钥"
  

二、openai.error.InvalidRequestError（GPT-3.5-turbo不支持v1/completions端点） #

问题原因 #

GPT-3.5-turbo属于聊天模型，必须调用OpenAI的v1/chat/completions接口；而代码中使用的openai.Completion.create()是调用v1/completions文本补全接口，仅支持text-davinci-003这类旧模型，二者参数结构完全不兼容。

解决办法 #

修改generate_response函数，改用openai.ChatCompletion.create()，并按照聊天模型要求构造messages参数：

修改后的核心代码

async def generate_response(message):
    # 聊天模型需传入messages数组，每个元素包含角色和内容
    messages = [
        # 可选：添加系统提示，定义AI的回复风格
        {"role": "system", "content": "你是一个友好的Discord聊天机器人，用简洁语言回复用户。"},
        {"role": "user", "content": message.content}
    ]
    response = openai.ChatCompletion.create(
        model="gpt-3.5-turbo",  # 聊天模型用model参数，而非engine
        messages=messages,
        max_tokens=1024,
        n=1,
        stop=None,
        temperature=0.5,
    )
    # 聊天模型的返回结果路径与补全模型不同
    return response.choices[0].message.content.strip()

完整修改后的代码 #

import discord
import openai
import os
from dotenv import load_dotenv

# 加载.env文件中的环境变量
load_dotenv()

openai.api_key = os.environ.get("OPENAI_API_KEY")
if not openai.api_key:
    raise ValueError("未检测到OPENAI_API_KEY环境变量，请正确设置")

# 指定Discord机器人权限
intents = discord.Intents.default()
intents.message_content = True  # 必须开启消息内容权限，否则无法读取用户消息
intents.members = True

# 创建Discord客户端
client = discord.Client(intents=intents)

async def generate_response(message):
    messages = [
        {"role": "system", "content": "你是一个友好的Discord聊天机器人，用简洁语言回复用户。"},
        {"role": "user", "content": message.content}
    ]
    response = openai.ChatCompletion.create(
        model="gpt-3.5-turbo",
        messages=messages,
        max_tokens=1024,
        n=1,
        stop=None,
        temperature=0.5,
    )
    return response.choices[0].message.content.strip()

@client.event
async def on_ready():
    print(f"已登录为 {client.user}")
    
@client.event
async def on_message(message):
    if message.author == client.user:
        return

    response = await generate_response(message)
    await message.channel.send(response)

# 从环境变量读取Discord Token（推荐用.env管理）
discord_token = os.environ.get("DISCORD_TOKEN")
if not discord_token:
    raise ValueError("未检测到DISCORD_TOKEN环境变量，请正确设置")

client.start(discord_token)

额外注意点 #

• Discord机器人需在开发者后台开启Message Content Intent权限，否则无法读取用户发送的消息。
• 禁止将API密钥、Discord Token硬编码到代码中，优先用环境变量或.env文件管理敏感信息，避免泄露。

内容的提问来源于stack exchange，提问作者RAFA 04128