配置速查
Open WebUI 只需要两个字段，但必须是管理员身份才能改。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
OpenAI API 地址 | https://turingapi.space/v1 | 必须带 /v1，同步走的是这个前缀 |
API 密钥 | 控制台创建的 sk- 密钥 | 填完点保存，不点保存不会生效 |
权限 | 管理员账号 | 普通用户看不到「连接」设置项 |
/v1/models 拉取模型清单。如果这个接口在你的分组里没有开放，同步就会失败——此时可以在连接里手动指定模型名，或者换一个开放了列表接口的分组。前置准备
确认你有管理员权限，这是最常见的卡点。
Open WebUI 的第一个注册用户默认是管理员。如果你用的是别人部署的实例，很可能没有权限。
在 注册页 建账号，控制台新建密钥并保存。
服务器要能访问 turingapi.space。内网部署又没放通出网时，表现是同步超时。
配置步骤
配置只需要一次，之后模型会随分组变化自动更新。
管理员面板配置 主流程
- 用管理员账号登录
- 点右上角头像 →「管理员面板」
- 进入「设置 → 连接」
- 在 OpenAI API 一栏填
https://turingapi.space/v1 - 填入 API Key，点保存
- 回到对话页，模型下拉里应该已经出现站内模型
保存后如果模型没出现，刷新一次页面；还不出现就看下面的同步排查。
模型同步不到怎么办 常见故障
- 先用 curl 确认
/v1/models是否返回数据 - 确认地址带
/v1且没有多余斜杠 - 检查服务器到
turingapi.space的网络是否通 - 实在同步不到，在连接设置里手动添加模型名
curl -H "Authorization: Bearer sk-你的密钥" https://turingapi.space/v1/models手动添加的模型同样可以正常调用，同步只是省事。
多个连接导致模型重名 特有坑
- Open WebUI 会把所有连接的模型合并成一个列表
- 两个连接里有同名模型时，可能指向了错误的那一个
- 建议只保留一个有效的 OpenAI 连接，或者在连接名称上做区分
自建用户常同时接本地 Ollama 和远程接口，模型名撞车时很难判断实际打到哪边。
验证是否配置成功
看到这些就说明通了
- 对话页顶部的模型下拉里有站内模型
- 选中并发送一条消息，能流式返回
- 控制台「用量」页出现记录
模型下拉里有了列表，说明 /v1/models 已经通，此时对话基本不会有问题。
对话报错但模型列表正常
- 确认选中的模型属于同一个分组
- 确认余额不为 0
- 换一个模型重试，判断是模型级问题还是连接级问题
模型列表能拉到但对话报错，通常是这个模型在该分组下没有权限，或余额不足。
常见问题
Open WebUI 的问题多半和权限、同步有关。
为什么我在设置里找不到「连接」？
因为你用的不是管理员账号。「连接」只在管理员面板里出现，普通用户是看不到的。
自建实例的话，可以进数据库把某个用户提升为管理员，或者用最初注册的那个账号。
模型列表一直是空的？
先确认 /v1/models 能通（用 curl 测），再确认地址带 /v1。都正常但在界面里拉不到，多半是实例本身出网有问题。
临时方案是手动指定模型名，不影响调用。
可以同时接本地模型和远程接口吗？
可以，Open WebUI 支持多个连接并存。但要注意模型重名——两个来源有同名模型时，列表里只显示一个，实际打到哪个不好判断。建议用明显不同的模型名区分。
为什么模型名后面带了一串前缀？
那是 Open WebUI 用来区分不同连接的显示名，不影响实际调用。真正发给接口的还是模型名本身。
相关客户端
CCherry Studio
图形界面配置，点「获取模型列表」自动拉取
LLobeChat
代理地址填 /v1，模型列表要手动加
DDify
要分别配 LLM 和 Embedding 两类模型
通通用 OpenAI 兼容
两种地址写法，互换一次就能解决大半问题
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。