APIMaster.ai
APIMaster.ai 使用文档
English快速开始APIMaster 官网模型广场

Open WebUI 配置 APIMaster.ai

用 Docker 安装 Open WebUI，并在 Connections 中接入 APIMaster.ai 的 OpenAI 兼容接口。

Open WebUI 是自托管的 LLM 聊天界面，支持通过 OpenAI 兼容 API 连接外部模型网关。APIMaster.ai 提供 https://apimaster.ai/v1，按本文配置后即可在 Open WebUI 里选用 模型广场 上的模型。

开始前请 获取 API Key。对话时选择的 model id 须与广场完全一致（如 gpt-5.4、claude-sonnet-4-6）。

前置条件

  1. 本机已安装 Docker（macOS / Linux / Windows 均可）。
  2. 网络允许 WebSocket 连接（Open WebUI 必需，见 官方 Quick Start 说明）。
  3. 已从 APIMaster 控制台 复制 API Key。

第 1 步：用 Docker 安装 Open WebUI

以下三步摘自 Open WebUI Quick Start with Docker 前几步。

1.1 拉取镜像

docker pull ghcr.io/open-webui/open-webui:main

也可使用 Docker Hub 同名镜像：openwebui/open-webui:main。

1.2 启动容器

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main
参数 作用
-p 3000:8080 在本机 3000 端口打开 Web UI
-v open-webui:/app/backend/data 持久化数据，重启不丢账号与配置

生产环境建议固定版本标签（如 :v0.9.6），见 Open WebUI 镜像说明。

1.3 打开界面

浏览器访问：

http://localhost:3000

首次注册的账号会自动成为 管理员，后续新用户需管理员审批（见 Open WebUI 安装后说明）。

第 2 步：进入 Connections 设置

  1. 使用管理员账号登录 Open WebUI。
  2. 点击顶部 Settings（设置）。
  3. 左侧选择 Connections（连接）。
  4. 找到 OpenAI API 区域，确保总开关为 开启。

在 URL 输入框填写 APIMaster 端点：

https://apimaster.ai/v1

Settings → Connections → OpenAI API

若尚未添加具体连接，可点击 URL 右侧 齿轮 或 + 进入连接编辑页（下一步）。

第 3 步：编辑 APIMaster 连接

在 Edit Connection（编辑连接）弹窗中填写：

字段 填写内容
URL https://apimaster.ai/v1
Auth Bearer
API Key 你的 APIMaster Key
Provider Default（默认即可）
API Type Chat Completions
Model IDs 留空 — 自动从 https://apimaster.ai/v1/models 拉取可用模型列表

Edit Connection — APIMaster

  • Headers：一般留空。
  • Prefix ID：留空。
  • 确认 URL 右侧开关为 开启，点击 Save 保存。

保存后，Open WebUI 会列出 APIMaster 上你有权使用的模型 id。

第 4 步：选择模型并对话

  1. 回到 Open WebUI 主界面（New Chat）。
  2. 在顶部 Select a model 下拉框中选择 APIMaster 模型（如 gpt-5.4）。
  3. 可选 Set as default 设为默认模型。
  4. 在输入框发送测试消息，确认有正常回复。

选择模型

对话示例

若列表中没有目标模型，请检查 Key 权限、分组与 模型广场 上的 model id 是否一致；也可在 Model IDs 中手动添加单个 id 后重试。

常见问题

连接失败或模型列表为空

  • 确认 URL 为 https://apimaster.ai/v1（含 /v1，末尾不要多余斜杠）。
  • 确认 API Key 有效且未过期，可在 第一次调用 用 curl 先测通。
  • 检查本机能否访问 https://apimaster.ai/v1/models。

页面无法加载或实时消息异常

Open WebUI 依赖 WebSocket。若经反向代理部署，需为 WebSocket 配置升级头；本地 localhost:3000 一般无此问题。

与 Ollama 的关系

本文仅接入 APIMaster 云端模型，不依赖 Ollama。若容器内同时跑 Ollama，请在 Connections 里分别配置，并在聊天页选择对应模型。

更新 Open WebUI

参考 Open WebUI 更新文档：停止旧容器 → docker pull 新镜像 → 用同一数据卷 -v open-webui:/app/backend/data 重新 docker run。

相关链接