跳转到主要内容
Open WebUI 是个自托管的模型聊天 Web 界面。除了 Ollama,它还能对接任意 OpenAI 兼容 API,所以 RuAPI 当成一个 OpenAI 连接接入即可——填地址和密钥就行。

前置

1

RuAPI 账号和密钥

控制台 →「令牌管理」→ 创建 sk-... 密钥。余额用 USDT 充——见充值。
2

跑起来的 Open WebUI

按 Open WebUI 文档安装(一般用 Docker)。

方式一:界面里配

1

打开连接设置

Admin Panel → Settings → Connections(或当前用户的 Settings → Connections)。
2

加一个 OpenAI 连接

启用 OpenAI API 并填:保存。Open WebUI 会通过 /v1/models 拉取模型列表。

方式二:用环境变量

启动容器时设置:

验证

新建聊天,选个模型(例如 claude-opus-5-5)发消息。有回复 + RuAPI 控制台 →「使用日志」有记录 = 正常。

知识库(RAG)

想让 Open WebUI 用 RuAPI 计算文档向量:管理员面板(Admin Panel)→ 设置(Settings)→ 文档(Documents)→ 嵌入模型引擎(Embedding Model Engine)选 OpenAI,填地址 https://www.ruapi.ai/v1、你的 RuAPI 密钥和模型 text-embedding-3-small(或 text-embedding-3-large),保存。也可以用环境变量:RAG_EMBEDDING_ENGINE=openai、RAG_OPENAI_API_BASE_URL=https://www.ruapi.ai/v1、RAG_OPENAI_API_KEY=sk-你的密钥、RAG_EMBEDDING_MODEL=text-embedding-3-small(地址和密钥可以不填,会沿用 OPENAI_API_BASE_URL 和 OPENAI_API_KEY)。环境变量只在第一次启动时生效,之后请在管理员面板里改。换了嵌入模型后,之前上传的文档要重新索引。嵌入模型充值后开放。

出问题时

  • 确认 Base URL 是带 /v1 的 https://www.ruapi.ai/v1:模型靠 /v1/models 拉取。
  • 密钥得是 RuAPI 令牌(sk-...)。
密钥错了或有空格。在 RuAPI 控制台 →「令牌管理」核对状态。
可以:Open WebUI 支持同时多个连接。本地 Ollama 模型和云端 RuAPI 模型会在同一个选择列表里。