API 限流与防重复提交

API 限流与防重复提交:阅读要点

在OmniAI Lab VIP API 接入中区分请求频率控制、网络重试和 Idempotency-Key 的使用范围。

限流后等待,不叠加请求

出现限流时按响应提示等待,适当降低并发和轮询频率。把一次请求失败直接复制成多次并发提交,会增加重复任务和进一步限流的风险。

网络超时和任务失败是两件事。请求超时后先查询已有任务,不能直接认定上一次创建没有成功。

同一逻辑请求使用同一幂等键

创建类请求按接口说明发送 Idempotency-Key,使用自己的业务单号或唯一标识。相同逻辑请求的重试保持键与请求内容一致;新业务请求使用新键。

幂等机制有适用接口和有效条件,应按现役文档核对。它不代表任何请求都可以永久复用同一个键,也不能替代客户端的提交防重复处理。

Idempotency-Key: YOUR_UNIQUE_BUSINESS_REQUEST_ID

内容核对: · OmniAI Lab VIP产品文档