Cherry Studio

Cherry Studio 通常可以通过 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

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

macOS / Linux

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

配置后如何验证

保存后发送一句简短测试消息。如果能正常返回，并且 SupaRouter 控制台能看到调用记录，说明配置已生效。

常见问题

• 401：检查 API Key 是否复制完整。
• model not found：检查模型名是否属于当前分组。
• 连接超时：检查本机网络、代理和防火墙。

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