新建连接
使用管理员账号进入 Open WebUI，打开 设置 → 管理员设置 → 连接。在 OpenAI 连接区域添加一个新连接：
保存后刷新或同步模型列表。若版本允许配置模型白名单，只填写实际可用的模型 ID。
Open WebUI 添加连接示例，展示 APIONE 地址与 Bearer 认证。
保存后，在连接列表中确认 APIONE 地址和对应的启用开关。
验证模型
回到聊天界面，新建会话并在模型选择器中选中 APIONE 模型。发送简单问题，确认能正常返回；再分别测试流式输出、图片或工具功能。多用户使用
模型连接由服务器调用，因此需要确认运行 Open WebUI 的服务器或容器可以访问 api.apione.ai。浏览器能打开官网并不能证明后端网络正常。团队环境下按角色分配模型访问权限，并在 APIONE 控制台管理该连接所用密钥的额度。常见问题
- 模型列表为空：检查连接是否已启用、密钥权限、/v1/models 是否可访问。
- 管理员可见而成员不可见：检查模型可见性和成员权限。
- 连接超时：从 Open WebUI 服务所在环境排查 DNS、代理和防火墙。
- 对话能用而知识库不能用：另外配置 Embedding 模型，不能用聊天模型替代嵌入模型。
返回集成目录 · 模型选择 · 错误排查