算力猫
← 返回教程列表

排错与安全

连不上、流式中断、选哪个域名

请求发不出去、超时、流式输出断掉时,一步步排查。

约 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)。