概览
创建任务时给同一业务请求使用相同的 Idempotency-Key。标识须为 1～160 个可见 ASCII 字符。同一 Key、同一 API 下，重复请求会返回原任务；相同请求标识配上不同参数会返回 409。新任务使用新的标识。
保留期限
任务处理中持续去重；任务结束后默认再保留 24 小时，平台可调整。超过保留期限后重新提交可能创建新任务。
各类异常的重试方式
- 提交时网络超时或连接中断：用同一幂等键和相同参数重试，避免重复创建任务。
- 已拿到任务 ID：继续查询该任务。queued、running、reviewing、cancelling 均不是失败，不要重新生成。
- 收到 429：根据错误码区分次数额度耗尽与临时限流。响应含 Retry-After 时，至少等待指定秒数；临时限流可逐步增加重试间隔。
- 收到其他错误：按错误码修正参数或处理账户问题。服务暂不可用时延迟重试；创建请求仍使用原幂等键。
排查需要的信息
报错时保留任务 ID、请求时间和响应中的 request_id，便于平台排查。不要发送完整 API Key。