排错与安全
连不上、流式中断、选哪个域名
请求发不出去、超时、流式输出断掉时,一步步排查。
约 6 分钟适合:遇到连接问题的用户
开始之前
- 一个终端
- 你的 Key(放在环境变量里)
步骤 1 · STEP 0x01
先用 curl 判断是哪一边的问题
terminal
$ curl -i https://api.suanlimao.shop/v1/models -H "Authorization: Bearer <你的 Key>"HTTP/2 200…
- curl 通、软件不通:问题在软件的设置(地址、/v1、模型名),回到那个软件的教程核对。
- curl 也不通:继续往下看网络和域名。
把
<你的 Key> 换成你的 Key(不要贴到别人看得到的地方)。步骤 2 · STEP 0x02
换一个接入域名
terminal
$ time curl -sS -o /dev/null https://api.suanlimao.shop/v1/models -H "Authorization: Bearer <你的 Key>"$ time curl -sS -o /dev/null https://api.suanlimao.shop/v1/models -H "Authorization: Bearer <你的 Key>"real 0m0.4s(时间越短越好;其中一个失败就用另一个)
- 中文界面默认把加速地址放在前面,大陆网络下更稳定;它连不上时,换成备选的 Cloudflare 域名。
- 英文界面只给 Cloudflare 域名。
- 在控制台「API Key」页和每把 Key 的分享页里,都能看到当前可用的所有地址。
某个域名被阻断时,只需要改软件里的地址,不用改 Key,也不用重新充值。
步骤 3 · STEP 0x03
排查本机网络
- 开着代理或 VPN 时,把接入域名加入直连(不走代理)规则试一试;系统代理有时会拖慢或打断长连接。
- 公司网络可能拦截陌生域名,换手机热点对比一下。
curl报证书错误:多半是本机时间不对,或公司网络在做 HTTPS 检查。
也可以先看状态页:它按模型显示最近 90 分钟、24 小时、7 天的成功率和首字节延迟。
步骤 4 · STEP 0x04
流式输出中途断了
terminal
data: {"choices":[{"delta":{"content":"…"}}]}: ping(突然没有后续了)
: ping是服务端发的保持连接的心跳,不是错误,客户端应该忽略。- 把客户端的读取超时调大(长回答和推理模型可能要几分钟);不要给流式请求设置过短的总超时。
- 中间的网关或反向代理如果开了响应缓冲,会让流式输出一块一块地卡住,关闭缓冲(例如 nginx 的
proxy_buffering off)。 - 断开时,已经生成的部分按 token 计费。
经 Cloudflare 的长请求偶尔会被中间层断开(常见表现是 524)。遇到时优先改用流式输出,或者换加速地址。
✓ 怎么确认成功了
- curl 返回 200,软件里也能正常对话;流式输出完整收到
[DONE]。
常见问题
一直转圈没有反应?
先判断是不是长回答;用流式输出能马上看到有没有内容在来。再用上面的 curl 对比。
所有方法都试过还是不行?
到控制台提交工单:附上 curl 命令的输出(不含 Key)、发生时间、你所在的网络(运营商或公司网络)。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。