SupaRouter 文档

Appearance

Open WebUI ​

Open WebUI 可以通过 OpenAI 兼容连接接入 SupaRouter。推荐先使用管理员设置里的连接配置；自部署场景也可以用环境变量预配置。

接入准备 ​

接入必备信息

  • Base URL
    • 普通场景使用 https://api.suparouter.xyz/v1
    • 大陆手机用户使用 https://api-cn.suparouter.xyz/v1
  • 模型名：确认当前 API Key 分组下要调用的模型名，本文档以gpt-5.5为例。
  • API Key：在 SupaRouter 控制台创建 API Key，确保模型和 API Key 的分组相同并保存好完整 Key。

管理员界面接入 ​

Windows ​

在 Open WebUI 中进入管理员设置，找到 Connections / 连接里的 OpenAI 或 OpenAI Compatible 配置，新增连接：

text
Connection Type: External
URL / Base URL: https://api.suparouter.xyz/v1
API Key: 你的 SupaRouter API Key
Model IDs: 当前分组下可用的模型名

如果 Open WebUI 能自动读取模型列表，可以直接保存后在模型选择器里选择模型。如果读取不到模型列表，手动把可用模型名加入 Model IDs 或模型过滤列表。

macOS / Linux ​

在 Open WebUI 中进入管理员设置，找到 Connections / 连接里的 OpenAI 或 OpenAI Compatible 配置，新增连接：

text
Connection Type: External
URL / Base URL: https://api.suparouter.xyz/v1
API Key: 你的 SupaRouter API Key
Model IDs: 当前分组下可用的模型名

如果 Open WebUI 能自动读取模型列表，可以直接保存后在模型选择器里选择模型。如果读取不到模型列表，手动把可用模型名加入 Model IDs 或模型过滤列表。

Docker 环境变量接入 ​

Windows ​

如果你用 Docker 部署 Open WebUI，也可以在启动参数或 Compose 文件里配置：

text
OPENAI_API_BASE_URL=https://api.suparouter.xyz/v1
OPENAI_API_KEY=你的 SupaRouter API Key

修改环境变量后需要重启 Open WebUI 容器。

macOS / Linux ​

如果你用 Docker 部署 Open WebUI，也可以在启动参数或 Compose 文件里配置：

text
OPENAI_API_BASE_URL=https://api.suparouter.xyz/v1
OPENAI_API_KEY=你的 SupaRouter API Key

修改环境变量后需要重启 Open WebUI 容器。

配置后如何验证 ​

保存后刷新页面，在模型选择器里选择 SupaRouter 模型，发送一句简短测试消息。如果能正常返回，并且 SupaRouter 控制台能看到调用记录，说明配置已生效。

常见问题 ​

  • 模型列表为空：手动填写当前分组可用的模型名。
  • 401：检查 API Key 是否复制完整，确认没有多余空格。
  • 连接超时：检查 Open WebUI 容器是否能访问外网。
  • Docker 中访问本机服务失败：如果连接的是宿主机上的本地服务，通常需要把 localhost 换成 host.docker.internal；接入 SupaRouter 云端 API 时不需要这样改。

更多通用排查见环境检查。