Open WebUI 接入指南

适用角色：管理员、开发者 更新日期：2026-08-06

Open WebUI 的外部连接通常由实例管理员统一配置。普通用户不需要接触 API Key，只需在聊天页选择管理员开放的模型。

管理员添加连接

进入管理员设置，找到外部连接或 OpenAI API 连接。下面图片来自 Open WebUI 实际界面，连接地址和凭据信息已替换或脱敏。

新增连接时填写：

字段	内容
URL	https://<接口地址>
API Key	本平台 API Key
模型 ID	可先留空让系统读取 /v1/models，也可手工添加调用名

以控制台「API Key」页展示的接口地址为准。

验证模型列表

保存后刷新模型列表。自动读取失败时，先用同一把 Key 请求 /v1/models，确认 Key 本身可用，再手工添加调用名。

多用户部署不要把管理员 Key 公开给普通用户。需要区分组织或额度时，可以为不同 Open WebUI 实例或连接创建独立的 Key。