客户端连接问题

客户端只显示“连接失败”时，按下面顺序缩小范围。不要同时修改多个设置。

1. 用 curl 建立基准

执行第一次请求。

• curl 失败：先排查密钥、分组、模型和网络。
• curl 成功：Sprelay 服务与账户基本正常，重点检查客户端。

2. 检查实际地址

客户端字段可能自动拼接路径。常见正确组合：

Base URL: https://sprelaytoken.com/v1
自动拼接: /chat/completions
最终地址: https://sprelaytoken.com/v1/chat/completions

常见错误组合：

https://sprelaytoken.com/v1/v1/chat/completions
https://sprelaytoken.com/v1/chat/completions/chat/completions

3. 检查客户端是否仍在使用旧配置

• 确认当前会话选择的是新 Provider。
• 关闭并重启客户端或终端。
• 检查系统环境变量是否覆盖界面设置。
• 检查多个配置文件中是否存在同名 Provider。

4. 检查模型

从客户端展示名称中找出真正发送的 Model ID。它必须与模型列表完全一致，并且密钥分组支持。

5. 检查网络与代理

• 浏览器能否打开 https://sprelaytoken.com。
• 系统时间是否准确，避免 TLS 验证失败。
• 暂时关闭会改写 HTTPS 的调试代理进行对比。
• 公司网络是否限制自定义 API 域名或长连接。
• 不要把本机代理地址填进 Sprelay Base URL。

6. 查看日志

站内没有请求日志，说明请求很可能没有到达服务；站内存在失败日志，则按API 错误码继续。

最小化客户端配置

排错时关闭知识库、联网搜索、插件、工具和图片，使用一个普通聊天模型发送短文本。成功后逐项恢复，找到引发问题的配置。