API Error: The operation timed out：请求超时怎么解决

30 秒结论

请求没在规定时间内等到完整响应。 先调大超时阈值，再查网络链路——大部分超时是客户端设置太短，不是服务挂了。

报错原文对照

Error: The operation timed out.
FetchError: request to https://api.example.com/v1/messages failed, reason: connect ETIMEDOUT
{"error":{"message":"upstream request timeout","type":"new_api_error"}}

原因排序

概率	原因
40%	客户端超时设得太短（默认 30s，长回答根本不够）
30%	上游高负载，响应慢
15%	网络链路问题（跨境、代理）
10%	中转站网关超时设置比自己还短
5%	流式响应中途断了

修法

调大超时

客户端	怎么调
OpenAI SDK	client = OpenAI(timeout=120)
Anthropic SDK	client = Anthropic(timeout=120)
Node fetch	AbortSignal.timeout(120_000)
curl	--max-time 180
Cursor	设置里找 Network / Timeout

长回答一定要 120 秒以上。生成 4000 token 在慢渠道上可能超过 60 秒。

判断是不是链路问题

curl -o /dev/null -s -w "连接: %{time_connect}s\n首字节: %{time_starttransfer}s\n总计: %{time_total}s\n" \
  https://api.example.com/v1/models -H "Authorization: Bearer $KEY"

• time_connect 高 → DNS 或网络链路
• time_starttransfer 高 → 服务端处理慢

责任判定表

现象	责任方
短请求正常，长回答超时	你的超时阈值
所有请求都超时	网络或站点挂了
只有高峰期超时	上游负载
换个网络就好	你的链路