环境准备
网络、代理与连接检查
把“网站能打开”和“模型能调用”分开验证。
先看站点连通性
curl --max-time 15 -i https://sotaai.org/health健康接口只能说明网关当前是否响应，不能证明你的密钥有效，也不能证明上游模型已经正常生成。继续使用带密钥的模型列表和最小生成请求完成验证。
检查响应类型
| 现象 | 优先检查 |
|---|---|
| DNS 解析失败 | 本机网络、DNS、域名拼写 |
| 连接或 TLS 失败 | 代理配置、系统时间、网络策略 |
| 返回 HTML / 登录页面 | 地址是否错误、客户端是否被重定向 |
| 连接成功但生成中断 | 客户端超时、代理缓冲、SSE 支持和上游错误 |
不要通过跳过 TLS 证书验证来长期使用接口。先查清连接或代理问题。
使用代理时
浏览器、终端和桌面客户端可能使用不同的代理设置，因此浏览器可以打开网站，不代表终端走同一路径。核对客户端的代理配置与组织网络要求。排查时只修改自己明确知道的配置。
给问题留下足够证据
记录时间与时区、客户端、最终请求路径、HTTP 状态和脱敏正文。不要把 curl -v 的完整输出直接发给别人；它可能包含 Authorization 请求头。
发现内容有误，或有未解答的问题？反馈文档问题 ↗