PHP8调用Kimi API超时本质是网络链路、客户端配置或服务端策略问题，需区分connect/read超时；必须使用https://api.moonshot.cn/v1地址，设置CURLOPT_CONNECTTIMEOUT_MS为3000、CURLOPT_TIMEOUT_MS为30000，禁用低速限制，并对429/502/504等状态码做2次重试及熔断。
PHP8 调用 Kimi API 出现超时，本质是请求在规定时间内没收到有效响应，不是模型“卡住”，而是网络链路、客户端配置或服务端策略三者之一或共同作用的结果。核心要区分是“连接不上”（connect timeout）还是“连上了但等不到结果”（read timeout），再对症处理。
检查网络与域名是否准确
国内用户必须用中国站专属地址，错一个字符就会 404 或长时间挂起：
- 确认 base_url 是 https://api.moonshot.cn/v1，不是 .ai、.com 或旧的 moonshot.ai 域名；
- 用 curl 命令快速验证连通性：
curl -v https://api.moonshot.cn/v1/models -H "Authorization: Bearer your_key"，观察是否卡在 CONNECT 或 TLS 握手阶段； - 如果服务器在海外或走代理，需确认出口 IP 是否被 Kimi 限流（特别是免费 Key 在境外调用时易触发风控）。
PHP8 客户端必须设两级超时
cURL 默认无读超时，PHP8 又默认启用严格模式，不显式设值极易卡死：
Kimi Search
下载
使用 Moonshot Kimi API 的 $web_search 内置工具进行联网搜索。当需要进行网络搜索获取实时信息时使用，支持中文和英文搜索查询。需要配置 MOONSHOT_API_KEY。
-
连接超时：用
CURLOPT_CONNECTTIMEOUT_MS控制 DNS 解析+建连时间，建议设为 3000（3秒）； -
读取超时：用
CURLOPT_TIMEOUT_MS控制整个请求生命周期，Kimi 大模型响应波动大，建议设为 30000（30秒）； - 禁用低速限制（
CURLOPT_LOW_SPEED_LIMIT和CURLOPT_LOW_SPEED_TIME），Kimi 流式响应初期可能速率偏低，误判为“挂起”而中断。
避开免费 Key 的硬性瓶颈
免费版 Key 有隐藏限制，不是“慢”，而是被服务端主动拦截：
立即学习“PHP免费学习笔记（深入）”；
- 速率上限仅 5 次/分钟，并发调用必触发 429；
- 单次最大 token 为 8K，若 prompt + response 接近该值，服务端会延迟返回甚至超时；
- 若控制台显示 “Quota exhausted”，当月所有请求都会静默失败——此时加长超时毫无意义，必须等重置或升级套餐。
加简单重试 + 熔断更稳
一次失败不等于永久不可用，短时抖动很常见：
- 用
curl_setopt($ch, CURLOPT_FAILONERROR, false)配合状态码判断，非 2xx 不直接报错； - 对 429（限流）、0（连接失败）、502/504（网关超时）做最多 2 次重试，间隔 1–2 秒；
- 若连续 3 次超时，暂停调用 30 秒（熔断），避免雪崩影响主业务。
