团队模型开放
复现：管理员保存连接，给一个测试用户授权目标模型，再分别新建对话。
通过：两种角色都能看到正确模型并得到回复；受限用户看不到不应公开的模型。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
在 Settings → Admin → Connections 增加 OpenAI 兼容连接，URL 填 https://api.apizt.com/v1。后台连接由 Open WebUI 服务端发请求；若启用 Direct Connections，网络位置改为浏览器，排错方法随之改变。
适合团队自部署的聊天入口，需要按成员或用户组控制模型。管理员连通、普通用户可见和 RAG 可用是三项不同验收。
按真实任务判断是否可用
文档问答 RAG
复现：文字聊天通过后上传一份测试文档，提问文档中的一句确定事实。
通过：模型能引用文档；embedding、检索和聊天链路分别有记录。
先选对协议和请求地址
管理员 Connections 的 OpenAI 接口由后端调用；容器网络需能访问 apizt。Direct Connections 由浏览器发请求，可能涉及浏览器网络和 CORS；两种模式不能混判。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
Settings → Admin → Connections → OpenAI API
URL：https://api.apizt.com/v1
API Key：apizt 令牌
Model IDs：留空读取 /models，或手动限制为授权 ID
验证：先 Verify Connection，再用目标用户聊天这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 Open WebUI 模型不显示 配置与验证清单照这个顺序接入
- 01
建立后端连接
管理员打开 Connections，新建 OpenAI API 连接并保存。模型列表太多时用 Model IDs 做白名单，手动录入不是聊天成功证明。
- 02
检查请求所在网络
Docker 部署时从容器所在环境测试 DNS 与 HTTPS；Direct Connections 要从目标用户浏览器检查。
- 03
验证用户和附加功能
先管理员、后普通用户聊天。标题生成、embedding、RAG、图片分别核对独立任务模型和访问权限。
对照工具配置与验证顺序
先选对协议和请求地址
本站绘制的内容说明图：本页 open-webui 的字段与路径示意，不仿造客户端界面；只问一句话与文件、工具任务分别验收。 若采用官方面板图，截图中的 MiniMax-M2.1 为旧演示；自己的准确型号与 Key 按本文配置，不表示 M3 接入完成。
出现这些现象，先查哪里
本站绘制的内容说明图：把本页具体错误与复现任务对照；官方配置说明、现有调用证据和未验证客户端能力仍分别记录。
先选对协议和请求地址
本页说明 Admin Connections 的 URL、认证与 Model IDs，官方面板与这些字段直接对应；图中 MiniMax-M2.1 仅是旧官方演示。
验证到哪一步？
官方文档确认 Connections、Verify Connection、Model IDs 和 Docker 网络注意事项；现有配图是配置示意。
- 现有依据
- 管理界面与路径已核对
- 验证边界
- 没有该自部署实例的真实管理员与普通用户实测。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
这个工具的费用怎样算
团队使用量应按用户与模型的全部请求合计。RAG 的 embedding 和标题生成可能另有调用；与单条聊天的 token 估算分开看。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| 容器内 models 请求超时 | 后端容器网络、DNS、代理或证书与宿主机不同。 | 在同一容器网络复测，记录连接错误，不只看浏览器是否能打开域名。 |
| 管理员能用，成员看不到 | 模型可见性或用户组权限没有开放。 | 以目标成员身份检查权限，而非继续重建 API 连接。 |
| 聊天可用，RAG 没有命中 | 文档处理或 embedding 服务是另一条链路。 | 检查文件索引状态、embedding 配置，再核对模型回答。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
分别用管理员和目标用户新建聊天；记录实际回答、模型权限和后台日志。仅浏览器能打开网关首页不代表容器能调用 API。
查看 Open WebUI 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
Open WebUI Docker 中模型连接失败怎么查？
管理员 Connections 从后端发请求，应在容器所在网络核对目标 API 可达性、代理和日志。Direct Connections 从浏览器请求，另查浏览器网络与 CORS；两种链路不能混用结论。
Open WebUI 管理员能用但普通用户看不到模型怎么办？
核对模型可见范围与用户组权限，在目标账号新建聊天验证。手动添加 Model IDs 只影响列表，不证明当前用户有权调用或接口可用。
Open WebUI 应该填写哪个 API 地址？
管理员 Connections 中的 OpenAI 兼容连接填 https://api.apizt.com/v1；该模式从后端发请求。Direct Connections 则从浏览器发请求，应分别排查。
终端请求成功，为什么客户端仍然失败？
管理员能用而普通用户看不到时，核对模型可见性和用户组权限。 聊天成功但标题生成或 RAG 失败时，分别检查任务模型与 embedding 配置，不能用聊天模型配置代替全部功能。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。