SupaRouter 文档

Appearance

Chatbox ​

Chatbox 支持添加 OpenAI 兼容服务商。由于不同版本的字段名称可能略有差异，请以客户端界面为准。

接入准备 ​

接入必备信息

  • 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 ​

进入 Chatbox 设置页，找到模型服务商或 Model Provider，新增一个自定义服务商：

text
Provider Name: SupaRouter
API Mode: OpenAI API Compatible
API Host: https://api.suparouter.xyz
API Path: /v1/chat/completions
API Key: 你的 SupaRouter API Key
Model: 当前分组下可用的模型名

如果你的 Chatbox 版本只提供 Base URL 或 OpenAI Base URL 字段，请填写：

text
https://api.suparouter.xyz/v1

macOS / Linux ​

进入 Chatbox 设置页，找到模型服务商或 Model Provider，新增一个自定义服务商：

text
Provider Name: SupaRouter
API Mode: OpenAI API Compatible
API Host: https://api.suparouter.xyz
API Path: /v1/chat/completions
API Key: 你的 SupaRouter API Key
Model: 当前分组下可用的模型名

如果你的 Chatbox 版本只提供 Base URL 或 OpenAI Base URL 字段，请填写：

text
https://api.suparouter.xyz/v1

添加模型 ​

至少添加一个当前分组可用的模型名。模型名需要和 SupaRouter 控制台展示一致，不要填写客户端内置的默认模型名。

如果客户端提供模型能力选项，可以先按普通文本模型保存，确认聊天可用后再按需要调整能力标记。

配置后如何验证 ​

保存后点击客户端里的连接检查，或新建一条对话发送简短测试消息。如果能正常返回，并且 SupaRouter 控制台能看到调用记录，说明配置已生效。

常见问题 ​

  • 404 或路径错误：检查是否把 /v1 写了两次。
  • 401：检查 API Key 是否复制完整。
  • model not found：检查模型名是否属于当前 API Key 的分组。
  • 连接检查失败但配置看起来正确：尝试新建对话发送短消息，并检查本机代理或网络环境。

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