超时后不可直接重试,须先用响应头x-request-id查询任务状态;仅对timeout/504超时、经指数退避(1.5s、4s)且最多2次、每次刷新timestamp与signaturenonce后才可重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

LiblibAI API请求超时后不能直接重试
当LiblibAI API返回超时(如 requests.exceptions.Timeout、HTTP 504 或 Connection timed out),说明客户端在等待响应时主动断开连接,但无法确认服务端是否已接收并开始处理该请求。此时立刻原样重试,可能造成重复生成、重复扣费、甚至触发风控拦截——尤其是文生图类非幂等操作,两次相同 prompt + seed 可能产出两张高度相似图,而平台侧已计费两次。
先确认请求是否已被服务端接收
LiblibAI 的文生图 API 支持通过 request_id 查询任务状态。超时发生后,必须优先执行这一步:
① 从原始请求的响应头中提取 X-Request-ID 字段值(若请求未发出或连接失败则无此字段);
② 调用 GET /v1/tasks/{request_id} 接口查询任务状态;
③ 若返回 "status": "success" 或 "status": "processing",说明请求已抵达服务端,不应重试;若返回 404 或 "status": "failed",才可考虑构造新请求。
注意:LiblibAI 不接受任意 request_id 查询,该 ID 必须来自你本次超时请求的响应头,伪造或复用旧 ID 将返回 403。
满足条件后才可有限重试
方法一:仅对明确属于网络抖动的超时启用重试
判断依据是错误类型必须严格匹配:requests.exceptions.Timeout、ReadTimeout、或 HTTP 状态码 504(Gateway Timeout)。其他如 400/401/429 均不可重试。
方法二:使用指数退避,且最多重试 2 次
第一次重试延迟 1.5 秒,第二次延迟 4 秒。超过两次即终止,改走人工查单流程。硬编码固定延迟会加剧服务端排队压力,LiblibAI 的限流策略对连续高频重试极为敏感。
方法三:重试前必须刷新签名三要素
每次重试都需重新生成 Timestamp(毫秒级整数) 和 SignatureNonce(全新 UUID v4,不含短横线),否则因时间戳过期或 nonce 重复,请求将被直接拒绝——这是 LiblibAI 风控规则中的强校验项。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











