不猜 Base URL 和模型 ID，准确连接 Open WebUI。

填写这些连接字段

已经验证什么，尚未验证什么

Open WebUI 官方兼容提供商指南说明，基础聊天必须有 POST /v1/chat/completions，并建议使用 GET /v1/models 发现模型；验证连接时会使用 Bearer Token 调用 /models。

在 Open WebUI 外先做两项检查

先确认 Key 和 Base URL 能返回模型列表。请在可信服务端 Shell 中执行，不能输出 Key 本身：

test -n "$PRIMORDIAL_API_KEY" || {
  echo "PRIMORDIAL_API_KEY 未设置" >&2
  exit 1
}

curl --fail-with-body --silent --show-error \
  https://www.primoraihub.com/v1/models \
  -H "Authorization: Bearer $PRIMORDIAL_API_KEY" \
  | jq -r '.data[]?.id'

从输出中复制一个准确 ID 到下一项测试。不要猜模型名，也不要使用旧文章中的 ID：

MODEL_ID="MODEL_ID_FROM_V1_MODELS"

curl --fail-with-body --silent --show-error \
  https://www.primoraihub.com/v1/chat/completions \
  -H "Authorization: Bearer $PRIMORDIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$MODEL_ID\",
    \"messages\": [{\"role\": \"user\", \"content\": \"Reply with OK\"}],
    \"stream\": false
  }"

第二项请求可能消耗账户额度。成功结果只验证一个模型、一个接口和一种非流式请求结构。

在 Open WebUI 中配置提供商

1. 使用管理员账户登录 Open WebUI。
2. 打开 Admin Settings → Connections → OpenAI，选择 Add Connection。
3. Provider type 保持 OpenAI，URL 填写 https://www.primoraihub.com/v1。
4. 把 Key 粘贴到 API Key 字段；不要添加 Bearer 、引号或尾随换行。
5. 首次验证时将 Model IDs 留空，然后保存连接。
6. 发现成功后，只把该 Open WebUI 实例需要的模型加入 Model IDs (Filter)。

Open WebUI 不同版本的菜单名称可能变化。如果当前界面不同，应以官方连接指南为准，同时保持上述 URL 和凭据边界不变。

先测试最小可用路径

1. 在新提供商连接下选择一个显示出来的模型。
2. 新建聊天，先关闭工具、网页搜索、知识库、图片和其他可选功能。
3. 发送简短 Prompt，确认出现完整的非流式或基础流式响应。
4. 在不记录凭据的前提下，对照 Primordial AI 用量和 Open WebUI 服务端日志。
5. 普通聊天成功后，每次只启用一个可选功能并重新测试。

模型选择器为空时，应把 Open WebUI 服务端的模型请求与模型发现测试对照。浏览器能打开 Open WebUI 页面，不等于其后端容器能访问提供商。

可选功能必须单独验证

Open WebUI 官方指南列出了额外可选接口：RAG 使用 /v1/embeddings，图片使用 /v1/images/generations，语音和转写使用音频接口。工具调用与流式还依赖所选模型和响应结构。

• 目标 Embedding 模型成功响应前，不要启用 RAG。
• 文本聊天成功不能证明图片接口可用；必须使用文档中的图片接口和 Payload 测试。
• 普通响应成功不能证明工具调用可用；应测试最小工具 Schema 并检查返回结构。
• 具体接口不可用时，保留备用连接或关闭该功能。

按症状排查

保护多用户 Open WebUI 连接

Open WebUI 管理员配置的提供商 Key，可能被获准用户用于消耗对应提供商账户额度。应保护管理面板、启用 HTTPS、按工作负载限制 Key、设置额度或过期控制、限制可见模型白名单并监控用量。

Open WebUI 官方指南建议多用户连接不要使用管理或 Master Key，而应优先使用最小权限凭据。这是 Open WebUI 的安全建议，不代表其对 Primordial AI 的背书。

常见问题