手动配置教程

如果你的客户端没有 SupaRouter 预设，但支持 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

Provider: SupaRouter
Base URL: https://api.suparouter.xyz/v1
API Key: 你的 SupaRouter API Key
Model: 当前分组下可用的模型名
API Type: OpenAI Compatible

不同客户端字段名可能不同，例如 Base URL、API Host、Endpoint 通常表示同一类地址配置。

macOS / Linux

Provider: SupaRouter
Base URL: https://api.suparouter.xyz/v1
API Key: 你的 SupaRouter API Key
Model: 当前分组下可用的模型名
API Type: OpenAI Compatible

不同客户端字段名可能不同，例如 Base URL、API Host、Endpoint 通常表示同一类地址配置。

填写顺序

1. 先新增一个自定义 OpenAI 兼容服务商。
2. 填写 Base URL 和 API Key。
3. 添加或选择模型名。
4. 保存后发送最小测试请求。

常见错误

• 把 Base URL 写成官网地址，而不是 API 地址。
• 使用了不属于当前分组的模型名。
• 客户端选择了 Claude、Gemini 等原生协议，而不是 OpenAI 兼容协议。