360智脑API超时需三端协同排查：先调高OneAPI流式超时至90秒并重启容器；再确认密钥权限匹配且模型ID填写准确；最后客户端设curl超时参数、禁用requests重试、监听流式心跳。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
360智脑API调用过程中出现超时，往往不是网络抖动那么简单——它可能直接导致请求中断、token计费失败、下游服务卡死，甚至触发OneAPI的熔断保护机制而自动禁用该渠道。必须从客户端、网关层、模型侧三端协同排查，不能只改一个地方。
确认超时是否由OneAPI网关引发
第一步：登录OneAPI管理后台 → 点击左侧「系统设置」→ 滚动到底部找到「全局超时设置」。
这里有两个关键阈值：【HTTP超时时间】（默认30秒）和【流式响应超时时间】（默认60秒）。360智脑在处理长文本生成或复杂推理时，实际响应常超过45秒，若流式超时设为60秒但中间无chunk返回，OneAPI会主动断开连接并报504 Gateway Timeout。
将「流式响应超时时间」调高至90秒，保存后重启one-api容器（docker restart one-api），再测试一次curl请求。这一步不做，后面所有优化都白搭。
检查360智脑API密钥与模型选型匹配度
方法一：核对密钥权限范围
登录360智脑开放平台 → 进入「我的应用」→ 点击对应App名称 → 查看「API权限」列表。确认已开通的模型中包含你正在调用的型号，例如360gpt2-pro或360gpt-turbo-32k-agent。若仅开通了360gpt-pro-trans（翻译专用），却在OneAPI中填入360gpt2-pro，请求会被路由到无权限节点，等待15秒后直接超时返回403。
方法二：强制指定低延迟模型
在OneAPI添加渠道时，「模型名称」字段不要留空或填通用名。必须精确填写360官方文档支持的模型ID，比如：360gpt-turbo-32k-agent比360gpt2-pro平均快2.3秒，且对Agent类请求有专属调度队列。填错一个字符（如多加下划线或大小写错误），OneAPI无法识别，就会 fallback 到默认慢速通道。
客户端侧主动控制超时与重试
① 使用curl测试时，必须显式声明超时参数：
curl -X POST "http://localhost:3000/v1/chat/completions" \-H "Authorization: Bearer sk-xxx" \-H "Content-Type: application/json" \--max-time 120 \--connect-timeout 10 \-d '{"model":"360gpt-turbo-32k-agent","messages":[{"role":"user","content":"你好"}]}'
注意：【--max-time必须≥OneAPI后台设置的流式超时值】，否则curl自身先中断，OneAPI日志里查不到真实错误原因。
② 若使用Python requests库，务必禁用默认重试机制：
requests.Session()默认启用urllib3的重试策略，而360智脑API不支持幂等重试——重复发送同一request_id会导致计费两次且第二次必然超时。需手动传入retry=urllib3.util.Retry(allowed_methods={"POST"})并关闭状态码重试。
③ 流式响应场景下，必须监听data字段心跳。360智脑每15秒会推送一个data: {"id":"chat...","object":"chat.completion.chunk","created":...}空数据帧。若连续25秒无任何data到达，应主动close连接并触发业务层降级逻辑，而不是傻等90秒。
