API Error: The operation timed out：请求超时怎么解决
AI API 超时的五种原因：客户端阈值太短、上游高负载、网络链路、代理丢连接、网关误报，附参数调整与判断表。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
超时timeout网络
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高 → 服务端处理慢
责任判定表
| 现象 | 责任方 |
|---|---|
| 短请求正常，长回答超时 | 你的超时阈值 |
| 所有请求都超时 | 网络或站点挂了 |
| 只有高峰期超时 | 上游负载 |
| 换个网络就好 | 你的链路 |
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证