LobeChat 国内 API 配置教程

官方入口:LobeHub 官方入口

更新于

适用范围:LobeChat/LobeHub 中提供 OpenAI 自定义服务地址的客户端或自部署版本。

版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。旧截图用于识别客户端入口;托管版与部署版配置位置可能不同。未在真实账号中验证付费模型调用。

配置速查

配置项填写内容注意事项
提供商OpenAI确认可编辑服务地址。
API Keyapizt API Key客户端与部署服务的配置分别核对。
代理地址https://api.apizt.com历史客户端字段为根地址;基址字段若要求 /v1 按版本填写。
模型 IDgpt-6-sol手动添加当前令牌可用模型。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

第 1 步:确认客户端版本与权限

打开已安装或自部署的 LobeHub 设置页,确认能编辑 OpenAI 自定义服务地址。客户端用户配置与部署环境变量的覆盖关系按该版本官方 README;托管版是否开放自定义接口须检查实际入口。

第 2 步:填写提供商、地址和令牌

历史客户端的代理地址填写 https://api.apizt.com,填入 apizt API Key,添加模型 gpt-6-sol。若当前版本明确要求 OpenAI 基础地址,则使用带 /v1 的基址。不要把设置页字段直接套到部署 BASE_URL 等变量;以当前官方说明和实际请求路径为准。

第 3 步:在新对话选中自定义模型

保存设置后新建对话,明确选中自定义模型。发送短消息并核对 apizt 日志中的模型与调用时间。模型列表未自动加载时,使用当前版本的自定义模型入口添加准确 ID。

lobechat 设置
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

怎样确认配置已生效

  1. 新会话选中配置的自定义模型。
  2. 客户端请求或服务日志能核对 apizt 地址。

接入失败时逐项检查

现象检查与处理
修改页面后仍用部署默认值检查管理员配置与用户配置优先级,重新保存并新开会话。
没有自定义地址入口确认所用版本及部署权限;托管版不能据此保证允许 BYOK。
模型列表空白手动添加准确 ID,再测试短消息。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。