LobeChat、Open WebUI 与 NextChat

这三类应用都可以使用 OpenAI 兼容协议,但它们对“API 地址”的定义不完全相同。先使用单一模型完成最小验证,再配置多用户、知识库或部署环境。

配置状态
  • 推荐协议: OpenAI Chat Completions
  • 配置格式核对: 2026-07-15
  • 运行验证: 待验证

Open WebUI

Admin Settings → Connections → OpenAI API 添加:

URL:     https://getrouter.ai/v1
API Key: YOUR_API_KEY

然后拉取模型,或手动使用 MODEL_ID。最终请求应为 /v1/chat/completions

LobeChat

在 Provider 设置中选择 OpenAI 或自定义 OpenAI:

API Key:  YOUR_API_KEY
Base URL: https://getrouter.ai/v1
Model:    MODEL_ID

如果使用自托管环境变量,请以当前 LobeChat 版本的变量名为准,不要把 Key 写进公开的前端构建变量。

NextChat

NextChat 某些版本的 API Endpoint 会自行添加 /v1,此时填写:

API Endpoint: https://getrouter.ai
API Key:      YOUR_API_KEY
Custom Model: MODEL_ID

如果当前版本明确要求 OpenAI Base URL 并只追加 /chat/completions,则使用 https://getrouter.ai/v1。出现 404 时以实际请求地址判断,不要反复猜测。

部署安全

  • 多用户部署不要把上游 Key 下发到浏览器;
  • 使用服务端 Secret 或平台密钥管理;
  • 为公开实例设置登录、额度和请求限制;
  • 为知识库、联网搜索和插件分别评估数据外发范围;
  • 使用独立 Key 便于撤销和审计。

验证清单

  1. 模型列表或手动模型 ID;
  2. 非流式聊天;
  3. 流式聊天;
  4. 多轮上下文;
  5. 图片输入;
  6. Tool Calling;
  7. 使用记录和费用。