腾讯混元API超时需区分处理：connect超时可安全重试，read超时须通过request_id或GetThread查询状态后再决定是否重试，且重试须带指数退避与最大3次限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API请求超时后不能直接重试，必须先判断超时类型并做对应处理，否则可能触发重复计费、状态不一致或限流加剧。
识别超时是网络层还是服务端响应超时
用 requests 发起调用时，需显式设置 timeout=(connect_timeout, read_timeout)，例如 timeout=(5, 30)。若在 connect 阶段（如 DNS 解析失败、TCP 握手失败）超时，说明请求根本未到达腾讯云服务器，此时可安全重试；若在 read 阶段超时（已建立连接但迟迟未收到完整响应），则请求大概率已进入混元服务队列，【此时直接重试会导致重复提交，且无法保证幂等】。
检查异常类型：捕获 requests.exceptions.ConnectTimeout 表示连接超时，可立即重试；捕获 requests.exceptions.ReadTimeout 表示读取超时，需走下一步判断逻辑。
读取超时后必须验证任务是否已执行
对 ChatCompletions 等非幂等接口，读取超时后不能假设失败——它可能已在服务端完成推理并返回了结果，只是网络中断导致你没收到。必须调用查询接口（如 GetThread）或通过唯一 request_id 在日志中反查。
方法一：启用 request_id 透传 → 在 headers 中加入 'X-TC-Request-ID': 'your_custom_id' → 超时后用该 ID 向腾讯云工单或 API Explorer 的「请求追踪」功能反查状态；
方法二：对支持会话的接口（如 GetThread），用 ThreadID 查询最新消息 → 若返回 status=completed 且 content 非空，则无需重试；若返回 404 或 status=processing，则按退避策略重试。
实施带退避的有条件重试
第一步：初始化重试参数 → max_retries = 3，base_delay = 1.0 秒，jitter = 0.3；
第二步：仅对 ConnectTimeout 和明确返回 503/504 的响应重试；
第三步：每次重试前 sleep(random.uniform(base_delay * (2 ** attempt), base_delay * (2 ** attempt) * (1 + jitter)))；
第四步：在第 3 次重试后仍失败，停止重试并记录 error_code=“timeout_unrecoverable”，【不可再发起第 4 次请求】。
