腾讯混元API调用需配置自动重试机制，推荐使用SDK内置retry_policy（如max_attempts=3、retry_by_status=["5xx","429"]），或手动实现指数退避重试；注意流式接口须重建request、避免重复prompt、务必记录RequestId。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API调用过程中网络抖动、临时限流或服务端瞬时不可用会导致请求失败，需要在代码中主动加入自动重试逻辑，避免单次失败就中断整个采集流程。
使用SDK内置重试机制（推荐）
腾讯云Python SDK v3.1.1000+ 已支持配置客户端级重试策略，无需手动捕获异常再循环调用。
第一步：初始化 Credential 时传入 【retry_policy】 参数，启用指数退避重试：
from tencentcloud.common import credential<br>cred = credential.Credential(<br> secret_id=os.getenv("TENCENT_SECRET_ID"),<br> secret_key=os.getenv("TENCENT_SECRET_KEY"),<br> retry_policy={ "max_attempts": 3, "retry_by_status": ["5xx", "429"] }<br>)
第二步：将该 cred 传入 HunyuanClient 初始化，后续所有 ChatCompletions 调用均自动生效重试：
client = hunyuan_client.HunyuanClient(cred, "ap-guangzhou")
注意：max_attempts=3 表示最多重试2次（首次+2次重试），总尝试次数为3次；429 状态码会被识别为限流，触发等待后重试。
手动实现带退避的重试循环
当需精细控制重试行为（如跳过特定错误、自定义等待时间、记录每次重试日志），可手动封装调用逻辑。
方法一：基础 while 循环 + 固定等待
设置最大重试次数为3，每次失败后 sleep 1 秒再重试：
import time<br>def call_with_retry(prompt):<br> for attempt in range(3):<br> try:<br> req = models.ChatCompletionsRequest()<br> req.Model = "hunyuan-pro"<br> req.Messages = [{"Role": "user", "Content": prompt}]<br> resp = client.ChatCompletions(req)<br> return resp<br> except TencentCloudSDKException as e:<br> if "InvalidParameter" in str(e) or "AuthFailure" in str(e):<br> raise e # 这类错误重试无意义，立即抛出<br> time.sleep(1)<br> raise Exception("API call failed after 3 attempts")
方法二：指数退避 + jitter 防雪崩
第1次失败等1秒，第2次等2秒，第3次等4秒，并加入随机抖动防止并发请求同时涌向服务端：
import time, random<br>def call_with_backoff(prompt):<br> for i in range(3):<br> try:<br> return client.ChatCompletions(req)<br> except TencentCloudSDKException as e:<br> if "ResourceUnavailable" in str(e) or "InternalError" in str(e):<br> wait = min(2 ** i + random.uniform(0, 1), 10)<br> time.sleep(wait)<br> else:<br> raise e<br> raise Exception("Call exhausted")
重试时必须避开的坑
流式接口（Stream=True）重试前必须重建 request 对象，不能复用已发送过的 req 实例，否则可能触发重复提交或状态错乱。
重试不应覆盖原始 prompt 内容——尤其当 prompt 含动态时间戳、UUID 或用户唯一标识时，重复使用旧 prompt 可能导致业务逻辑错误或去重失效。
生产环境务必记录每次重试的 RequestId 和错误码，方便后续排查是否为区域性故障或配额耗尽：【不记录 RequestId 的重试等于盲跑】
