BetterChatGPT 使用前要改的配置:接口地址、密钥与模型名
BetterChatGPT 默认连接 OpenAI 官方接口,如果服务器在国内或使用中转 API,直接打开对话会提示连接失败或密钥无效。
要让 BetterChatGPT 真正用起来,核心是在设置里把接口地址、API 密钥和模型名换成你实际可用的值,然后发一条消息验证是否连通。
先确认你手里有什么
动手改配置前,先准备三样东西:
- 接口地址:官方是
https://api.openai.com/v1,中转服务商通常会给你一个以/v1结尾的地址。 - API 密钥:形如
sk-开头的一串字符,确保没有多余空格。 - 模型名:常见如
gpt-3.5-turbo、gpt-4o,以服务商实际支持的为准。
如果使用宝塔面板部署,先确认站点已经能正常打开登录页,再进入应用内修改配置,否则配置改了也看不到效果。
在设置面板里替换三项配置
登录 BetterChatGPT 后,点击左下角或侧边栏的 设置(Settings),找到 API 设置 区域。
不同版本界面文字略有差异,重点找接口地址、API Key、模型三个输入框。
把默认值逐项替换:
- 接口地址:填入服务商提供的完整地址,末尾不要多加斜杠。
- API Key:粘贴你的密钥,注意前后不要带引号。
- 模型名:填服务商实际支持的模型标识,不要直接照抄官方示例。
保存后关闭设置面板,回到对话页。
部分版本需要刷新页面才能让新配置生效。
用一条消息验证是否连通
新建对话,发送一句简单测试,例如“你好,请回复收到”。
观察结果:
- 能正常返回文字,说明接口地址、密钥、模型名三项都匹配。
- 提示 401 或“密钥无效”,优先检查密钥是否复制完整、是否被服务商禁用。
- 提示 404 或“模型不存在”,说明模型名填错,去服务商文档核对准确名称。
- 一直转圈或超时,检查服务器网络能否访问该接口地址,可用
curl在服务器上测试:
curl -s https://你的接口地址/v1/models \
-H "Authorization: Bearer 你的密钥"
返回 JSON 列表说明网络和密钥都正常,问题出在模型名或前端配置未保存。
容易踩的几个坑
接口地址多写路径:只填到 /v1,不要带 /chat/completions,客户端会自己拼接。
密钥泄露:BetterChatGPT 的密钥保存在浏览器本地,不要在公用电脑上保存。
中转服务不稳定:部分中转服务会限流或随时更换模型名,出现时好时坏先换回官方接口对比测试。
修改后不生效:先刷新页面,再检查浏览器控制台是否有跨域报错,跨域问题需要在部署端配置反向代理。
配置完成后做什么
首次对话成功后,建议在设置里再确认一次“模型”下拉框是否显示你填写的名称,避免后续新建对话时被重置为默认值。
如果多人使用同一套部署,密钥应放在服务端环境变量中,而不是让每个用户自己填,具体方式取决于你使用的部署版本,以项目文档为准。
BetterChatGPT 使用本身不复杂,真正卡住新手的通常是接口地址和模型名不匹配。
按“先测网络、再验密钥、最后对模型名”的顺序排查,基本能在几分钟内定位问题。