客户端接入 · Open WebUI

Open WebUI 接入 HardysAPI:连接地址填公网域名

Open WebUI 在「管理员设置 → 连接」里配置上游。最常见的坑是把它填成 localhost——容器里的 localhost 不是你的电脑。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

配置步骤

  1. 用管理员账号登录,点右上角头像 → Admin Panel → Settings → Connections;
  2. 在 OpenAI API 一栏,API Base URL 填 https://hardysapi.com/v1;
  3. API Key 粘贴 sk-...;
  4. 点右侧的刷新按钮,模型列表应自动出现;
  5. 保存后在聊天页顶部选择模型。
⚠️ Open WebUI 跑在 Docker 里时,http://localhost:8080 指的是容器自己。 上游是公网站点,直接写 https://hardysapi.com/v1 即可,不需要 host.docker.internal。

用环境变量预置

多人使用又不想每人配置时,可以在启动时注入,用户端就默认可用:

docker run 片段bash
-e OPENAI_API_BASE_URL=https://hardysapi.com/v1 \
-e OPENAI_API_KEY=sk-你的密钥

注意:这会让所有用户共用同一个密钥、同一个分组。公共实例建议按用户分发各自的密钥。

常见坑

  • 模型列表是空的:多半是 Base URL 少了 /v1,或者密钥所在分组没有可用模型;
  • 能拉到模型但对话报错:模型名来自缓存,该分组已下架该模型,刷新后重选;
  • 流式输出断开:反代(nginx)的 proxy_buffering 需要关闭,否则 SSE 会被缓冲成一整块。

常见问题

Open WebUI 的 API Base URL 填 localhost 为什么不行?

因为 Open WebUI 通常跑在容器里,localhost 指容器自身。上游在中转站,直接填公网地址 https://hardysapi.com/v1。

Open WebUI 怎么让所有用户共用一个密钥?

通过环境变量 OPENAI_API_BASE_URL 与 OPENAI_API_KEY 预置,或在管理员设置里配置;多人共用时注意用量会记在同一个账户上。