前置
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-...)。
401 / 授权失败
401 / 授权失败
密钥错了或有空格。在 RuAPI 控制台 →「令牌管理」核对状态。
想同时留着 Ollama 和 RuAPI
想同时留着 Ollama 和 RuAPI
可以:Open WebUI 支持同时多个连接。本地 Ollama 模型和云端 RuAPI 模型会在同一个选择列表里。