全部教程 /

在 Open WebUI 中使用 XHuoAPI

Open WebUI 可以同时挂多条 OpenAI 兼容连接。加一条指向 XHuoAPI 的连接后,全部可用模型会出现在模型选择器里。

开始之前

先验证一下

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

配置步骤

1

用管理员账号登录,进入 Admin Settings → Connections,找到 OpenAI 一栏,点旁边的扳手图标 Manage。

2

点 Add New Connection。Connection Type 选 External,填 URL 和 API Key:

URL:      https://api.xhuoapi.ai/v1
API Key:  sk-...
3

Model IDs 留空即可,Open WebUI 会通过 /models 接口自动拉取全部可用模型。想只露出几个模型给用户时再填,这个字段是白名单。

4

Docker 部署时也可以直接用环境变量,效果相同:

OPENAI_API_BASE_URL=https://api.xhuoapi.ai/v1
OPENAI_API_KEY=sk-...
ENABLE_OPENAI_API=true

注意事项

如果还接了别的供应商且模型名重复(比如两边都有 qwen3.8-max),在连接设置里填 Prefix ID,模型会显示成 前缀/模型名 以区分。
Qwen 系列与图像/视频模型只在 Standard 与 Official 分组可用。令牌建在 Saver 或 Spot 分组下时,这些模型会返回「模型不可用」。

常用模型