SupaRouter 文档

Appearance

OpenAI SDK / 通用 SDK ​

支持自定义 base_url 和 API Key 的 OpenAI 兼容 SDK，通常可以接入 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 ​

  • Base URL：https://api.suparouter.xyz/v1
  • API Key：SupaRouter 控制台创建的 Key。
  • Model：当前分组下可用的模型名。

macOS / Linux ​

  • Base URL：https://api.suparouter.xyz/v1
  • API Key：SupaRouter 控制台创建的 Key。
  • Model：当前分组下可用的模型名。

适用场景 ​

  • OpenAI 官方 SDK 的兼容调用。
  • LiteLLM、LangChain 等支持 OpenAI 兼容接口的工具。
  • 其他允许填写 Base URL、API Key 和模型名的 SDK。

先验证再集成 ​

建议先用最小请求验证连通性，再接入你的业务代码。这样可以更容易区分是 SupaRouter 配置问题，还是业务层参数、流式输出或代理设置问题。

如果你需要手动迁移现有 OpenAI 配置，请查看手动配置教程。