配置速查
LobeChat 有两个字段容易填错位置。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
API 代理地址 | https://turingapi.space/v1 | 填在「代理地址」这一栏，不是「接口地址」 |
API Key | 控制台创建的 sk- 密钥 | 填完必须点检查，通过后再保存 |
模型列表 | 从 模型列表 复制的模型名 | LobeChat 不会自动拉取，必须手动加 |
/v1 的完整地址——它不会帮你补路径。前置准备
LobeChat 网页版可以直接配置；自部署版还需要注意请求模式。
在 注册页 建账号，控制台新建密钥并立刻保存。
LobeChat 的模型列表是手动维护的，先把要用的模型名从 模型列表 复制出来放着。
网页版默认「服务端请求」，请求由 LobeChat 服务器转发；切成「客户端请求」后从浏览器直连，见下面的说明。
配置步骤
两条路径：网页版改设置，自部署版还可以走环境变量。
图形界面配置 主流程
- 进入「设置 → 语言模型」
- 在提供商列表里选
OpenAI - 填入 API Key
- 在「API 代理地址」填
https://turingapi.space/v1 - 点「检查」，通过后保存
- 在模型列表里点「获取模型列表」或手动添加模型名
「检查」不通过时先别急着保存，多半是地址多了或少了一层 /v1。
手动添加模型 必做
- 回到 OpenAI 提供商设置，展开「模型列表」
- 点「添加模型」，填入模型名
- 每个模型单独加一条，别用逗号堆在一个框里
claude-sonnet-5
gpt-6.1-sol
grok-4.7LobeChat 的模型列表决定了对话页顶部能选到什么。不添加的话，只能选它内置的官方模型名。
服务端请求 vs 客户端请求 特有坑
- 「服务端请求」由 LobeChat 后端转发，密钥不出服务端，最安全
- 「客户端请求」从浏览器直接发，密钥会出现在浏览器请求头里
- 浏览器直连还可能被 CORS 或公司网络代理拦掉
- 多人共用的部署，务必保持服务端请求
自己一个人用问题不大；一旦部署给团队用，客户端模式等于把密钥发给所有人。
验证是否配置成功
看到这些就说明通了
- 在对话页选一个刚添加的模型
- 发一句话，能流式返回
- 控制台「用量」页出现记录
如果「检查」通过但对话报错，通常是模型名不在该分组里。
检查不通过时的排查
- 确认填的是「API 代理地址」而不是别的字段
- 地址必须是
https://turingapi.space/v1 - 密钥前后不要带空格
LobeChat 的检查会对 /v1/models 发一次请求。这个接口在部分分组里可能不开放，此时检查会失败但对话功能正常——不要因为这个提示就断定配错了。
常见问题
LobeChat 的问题集中在「填错字段」和「模型选不出来」两类。
填了地址还是连官方，怎么回事？
很可能填错了字段。LobeChat 只有在「API 代理地址」里填了值才会改道，填到别的地方不生效。
改完记得点「检查」再保存，直接关面板有时不会写入。
模型下拉里没有站内的模型？
LobeChat 不会自动同步模型列表，必须在提供商设置里手动添加。把站内的模型名逐条加进去即可。
检查提示失败，但能正常对话？
正常。检查动作会请求 /v1/models，部分分组没有开放这个接口，所以检查报错但 /v1/chat/completions 是通的。
判断标准以实际对话能否返回为准，不必纠结这个提示。
函数调用 / 插件怎么配？
选一个支持 tools 的模型，然后在模型设置里打开「函数调用」开关。模型不支持 tools 时插件会一直不返回结果，也不报错。
相关客户端
CCherry Studio
图形界面配置，点「获取模型列表」自动拉取
NNextChat
地址不能带 /v1，它会自己补
CChatBox
API 模式要选 OpenAI Compatible
OOpen WebUI
管理员面板配置，模型自动同步
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。