> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Open WebUI 接入 APIONE

> 通过管理员连接设置添加 APIONE 模型。

## 新建连接

使用管理员账号进入 Open WebUI，打开 **设置 → 管理员设置 → 连接**。在 OpenAI 连接区域添加一个新连接：

| 字段 | 内容 |
| - | - |
| 名称 | APIONE |
| URL / Base URL | [https://api.apione.ai/v1](https://api.apione.ai/v1) |
| API Key | APIONE API Key |

保存后刷新或同步模型列表。若版本允许配置模型白名单，只填写实际可用的模型 ID。

![Open WebUI 添加连接示例，展示 APIONE 地址与 Bearer 认证。](https://mintcdn.com/apione/eGTb2vS-514SNt6Q/images/integrations/screenshots/open-webui-add-connection.png?fit=max\&auto=format\&n=eGTb2vS-514SNt6Q\&q=85\&s=4147ded816aa90e8bb08bc1d46df585a)

Open WebUI 添加连接示例，展示 APIONE 地址与 Bearer 认证。

![Open WebUI 连接列表中的 APIONE 地址与启用开关](https://mintcdn.com/apione/zM1w3ic8px2lIvc_/images/integrations/screenshots/open-webui-apione-enabled.png?fit=max\&auto=format\&n=zM1w3ic8px2lIvc_\&q=85\&s=456d0cdcbc1ee2451f95440771fe7253)

保存后，在连接列表中确认 APIONE 地址和对应的启用开关。

## 验证模型

回到聊天界面，新建会话并在模型选择器中选中 APIONE 模型。发送简单问题，确认能正常返回；再分别测试流式输出、图片或工具功能。

## 多用户使用

模型连接由服务器调用，因此需要确认运行 Open WebUI 的服务器或容器可以访问 api.apione.ai。浏览器能打开官网并不能证明后端网络正常。团队环境下按角色分配模型访问权限，并在 APIONE 控制台管理该连接所用密钥的额度。

## 常见问题

* 模型列表为空：检查连接是否已启用、密钥权限、/v1/models 是否可访问。
* 管理员可见而成员不可见：检查模型可见性和成员权限。
* 连接超时：从 Open WebUI 服务所在环境排查 DNS、代理和防火墙。
* 对话能用而知识库不能用：另外配置 Embedding 模型，不能用聊天模型替代嵌入模型。

客户端安装与管理入口参见 [Open WebUI 官方文档](https://docs.openwebui.com/)。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.