LobeChat 集成教程

LobeChat 是一款现代化、开源的 AI 对话前端，支持丰富的插件生态和自定义 API。本文介绍如何配置 LobeChat 使用玄州API。

配置步骤

方式一：直接使用 LobeChat Cloud

如果你使用的是 LobeChat Cloud 或自部署版本：

1. 打开 LobeChat，点击左下角「设置」图标
2. 选择「语言模型」
3. 找到「自定义模型」

方式二：Docker 部署 LobeChat + 玄州API

docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx \
  -e OPENAI_PROXY_URL=https://xuanzhouapi.top/v1 \
  -e ACCESS_CODE=your-password \
  lobehub/lobe-chat

部署完成后访问 http://localhost:3210，使用你设置的 ACCESS_CODE 登录。

方式三：Vercel 部署

在你的 LobeChat Vercel 项目中，设置环境变量：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_PROXY_URL=https://xuanzhouapi.top/v1
ACCESS_CODE=your-password

添加模型

在 LobeChat 设置的「语言模型」中，进入「自定义模型」：

1. 输入模型名称，如 gpt-5.5
2. 点击右侧的 + 添加
3. 重复添加你需要的其他模型

推荐的模型组合：

gpt-5.5
gpt-5.5-s
claude-opus-4-7-s
claude-sonnet-4-6
deepseek-v4-pro
deepseek-v4-flash
gemini-3.5-flash
doubao-seed-2.0-pro
glm-5.1
kimi-k2.6

添加后，在聊天界面的模型选择器中即可切换使用。

图片识别配置

需要使用图片识别功能时，选择支持多模态的模型：

• gpt-5.5
• claude-opus-4-7
• claude-sonnet-4-6
• gemini-3.5-flash
• doubao-seed-2.0-pro

在 LobeChat 中直接上传图片，AI 会自动识别。

常见问题

1. 无法连接

• 确认 OPENAI_PROXY_URL 格式正确：https://xuanzhouapi.top/v1
• 确认 OPENAI_API_KEY 包含了完整的 sk- 前缀
• Docker 部署时检查容器日志：docker logs <container-id>

2. 模型列表不显示自定义模型

• 刷新页面后重试
• 清除浏览器缓存
• 检查模型名称拼写是否与模型广场一致

3. 消息发送后无响应

• 检查账户余额是否充足
• 在控制台「日志查询」中查看是否有请求记录
• 检查该模型是否在你的 API Key 分组中可用