Open WebUI 可以连接 APIBox 吗？

可以。在 Open WebUI 中添加 OpenAI 兼容连接，把 API URL 设置为 https://api.apibox.cc/v1，并填写 APIBox API Key。

Open WebUI 接入 APIBox 的 Base URL 填什么？

填写 https://api.apibox.cc/v1。/v1 后缀很重要，因为 Open WebUI 需要 OpenAI 兼容 API 路径。

Open WebUI 加载不出模型列表怎么办？

可以在 Model IDs filter 或 allowlist 中手动添加模型名。有些供应商或网关即使 chat completions 可用，也可能需要手动填写模型。

一个 Open WebUI 可以通过 APIBox 使用多个模型吗？

可以。APIBox 连接配置好后，可以在模型选择器或 allowlist 中使用 GPT、Claude、Gemini、DeepSeek 等支持的模型 ID。

Open WebUI 接入 APIBox 配置教程

Open WebUI 可以把 APIBox 当作 OpenAI 兼容供应商来连接。核心配置很简单：API URL 填 https://api.apibox.cc/v1，API Key 填你的 APIBox Key，再添加你想在 Open WebUI 里显示的模型 ID。 这样，一个自部署聊天界面就能通过同一个入口使用 GPT、Claude、Gemini、DeepSeek 等 APIBox 支持的模型。

1. 快速配置表

Open WebUI 字段	APIBox 填写值
Provider 类型	OpenAI-compatible 或 OpenAI connection
API URL / Base URL	`https://api.apibox.cc/v1`
API Key	你的 APIBox Key
Model IDs	添加你想使用的 APIBox 模型名
首次测试	用一个模型发送短消息

这个配置适合这些需求：

把 Open WebUI 连接到 OpenAI 兼容 API
用一个 API Base URL 管理多个模型家族
在私有聊天界面里加入 Claude、GPT、Gemini 或 DeepSeek
解决模型列表或模型 ID 问题
给团队提供一个可控的多模型 Web UI

2. 在界面中逐步配置

在浏览器打开你的 Open WebUI 实例。
进入 Admin Settings。
打开 Connections。
选择 OpenAI 或 OpenAI-compatible 连接区域。
添加一个新连接。
API URL 填 https://api.apibox.cc/v1。
粘贴 APIBox API Key。
如果模型无法自动发现，就手动添加模型 ID。
保存连接。
在聊天界面选择一个模型，发送短消息测试。

推荐首测内容：

简短回复：APIBox 已连接。

如果能返回结果，再继续测试流式输出和较长 prompt。

3. 可选 Docker 环境变量配置

如果你更习惯用环境变量，Open WebUI 文档中有 OPENAI_API_BASE_URL、OPENAI_API_BASE_URLS、OPENAI_API_KEY、OPENAI_API_KEYS 等 OpenAI 兼容配置项。不同 Open WebUI 版本行为可能不同，所以第一次配置通常建议先用管理界面完成。

一个简单的单供应商配置通常类似：

OPENAI_API_BASE_URL=https://api.apibox.cc/v1
OPENAI_API_KEY=your_apibox_key

如果是多供应商配置，请按照你正在运行的 Open WebUI 版本文档，必要时使用复数形式变量。

4. 应该添加哪些模型 ID

建议一开始只添加少量模型。模型过多会让选择器变乱，也不利于团队形成评测习惯。

使用场景	模型选择方向
普通聊天	GPT 或 Claude 通用模型
编程辅助	Claude 或 GPT 编程模型
成本敏感聊天	DeepSeek 或较低成本的 GPT/Gemini 模型
长上下文阅读	长上下文能力强的模型
推理任务	支持强推理的模型

当前可用模型名建议以 APIBox 模型广场/定价页为准：

APIBox 模型广场/定价

5. 常见错误与解决办法

连接测试失败

Open WebUI 可能会通过调用 /models 来验证供应商。如果模型发现失败，但 chat completions 本身可用，可以手动在 filter 或 allowlist 中添加模型 ID，然后直接测试聊天请求。

401 Unauthorized

检查：

API Key 是否复制完整
Key 是否属于 APIBox，而不是其他供应商
Key 前后是否有空格
修改后是否保存了连接

404 或 model not found

检查：

模型 ID 拼写
该模型是否在你的 APIBox 账户中可用
模型 ID 是否手动加入了 Open WebUI allowlist

Base URL 错误

使用：

https://api.apibox.cc/v1

OpenAI 兼容 chat completions 不要漏掉 /v1。

流式输出不顺滑

检查：

所选模型是否支持流式输出
反向代理是否缓冲了响应
部署平台 timeout 是否过短
prompt 是否要求输出过长内容

6. Open WebUI + APIBox 适合哪些场景

这个组合适合：

团队需要私有 Web 聊天界面
需要同时使用多个模型家族
想用一个 OpenAI 兼容连接替代多个供应商账号
想在一个界面里比较 GPT、Claude、Gemini、DeepSeek
非开发成员需要受控的模型选择器

不太适合：

只做一次性 API 测试
必须使用 Open WebUI 没有暴露的供应商原生能力
公司需要完全自定义的产品界面

7. 首次聊天成功后的下一步

第一次返回成功后，建议继续做：

限制可见模型列表。
给日常聊天设置更便宜的默认模型。
把强模型留给编程、推理或长上下文场景。
记录每类工作流应该用哪个模型。
在 APIBox 控制台跟踪消耗。
团队正式依赖前，先测试模型行为。

8. 推荐配置

Open WebUI 接入 APIBox 的方法是：添加 OpenAI 兼容连接，把 API URL 设置为 https://api.apibox.cc/v1，粘贴 APIBox API Key，并添加你要使用的模型 ID。如果 Open WebUI 无法自动加载模型列表，就在 Model IDs filter 中手动添加模型名，然后直接测试 chat completions。

可以先注册 APIBox 获取 Open WebUI 所需的 API Key。