LobeChat 自定义 API 配置：代理地址、模型列表与联调

先辨认使用的是哪一代界面

LobeChat 所在的官方主仓库目前以 LobeHub 展示，旧版教程中的菜单名称不一定与新界面一致。 本文核对的是官方 OpenAI 服务商设置与自托管环境变量，不假定所有云端账户都开放相同配置。资料已核验，但本站没有安装客户端或接入实测。

在服务商设置中填写地址

官方路径是 App Settings → AI Providers → OpenAI：启用服务商，填写 API Key；使用兼容接口时填写代理 URL，随后用 Check 检查连接。模型还要在服务商列表中启用，并在 Agent 设置中选中，保存密钥不等于完成模型选择。

下面是纯占位的配置清单，不是真实 API；本站未据此提供账户、密钥创建或充值服务。实际地址与模型请使用服务方正式提供的值。

代理 URL：https://80321.cn/v1
API Key：YOUR_API_KEY
模型 ID：YOUR_MODEL_ID

代理字段填写基础地址，不把一次聊天的完整请求路径塞进去。先向服务方确认是否保留版本前缀；官方变量说明特别提醒，代理转发方式不同，是否需要 /v1 也不同。

自托管实例有另一层默认值

部署者可用 OPENAI_API_KEY 设置服务端密钥、OPENAI_PROXY_URL 覆盖默认地址、OPENAI_MODEL_LIST 控制可选模型。后者用加号添加模型、减号隐藏模型，也支持给模型设置显示名。 新增条目可以写成 +YOUR_MODEL_ID，但它只是界面登记，不能为账户增加上游权限。

如果页面仍显示旧地址，先核对运行实例是否载入新变量，再检查个人服务商设置。不要同时改部署层、个人层和代理转发规则，否则难以定位哪一层真正生效。

协议选择与最小联调

此路径用于 OpenAI 服务商及其兼容端点。 Gemini 原生格式或 Anthropic Messages 不能只换域名就当作同一协议；图片、工具调用与文件处理也需逐项核对目标模型能力。

先选择一个正式确认的文本模型，新建没有插件的短对话，只发“请回复一句中文确认信息”。观察连接检查、首条文本和连续第二轮；之后再加流式输出、工具或知识库。普通聊天返回内容不能证明这些附加能力都能用，更不能证明请求一定走了预期代理。

排错与密钥边界

模型不在列表时先查启用状态和模型 ID，别用显示名替代请求名称。空回复优先核对版本前缀与实际转发路径，这是官方文档点出的兼容问题。 认证错误检查密钥属于哪家服务，路径错误检查代理是否重复拼接版本号。

部署端共享密钥需要配合访问控制；个人配置、导出文件和排错日志也应脱敏。首次联调用专用低权限密钥和非敏感文本，不上传公司的知识库来试连接。确认请求实际发往可信主机后，再评估是否适合业务使用。