幂等与重试
内容版本 v2026.10.22 · 所属 模型 API / 对话与流式
概览
网络抖动时重试是必要的，但重试不能造成重复扣费或重复写入。
| 项 | 说明 |
|---|
| 幂等键 | 请求头 Idempotency-Key |
| 作用 | 同一键 24 小时内只执行一次 |
| 重试 | 仅对 5xx 与超时重试 |
| 退避 | 指数退避 + 上限 |
操作步骤
- 生成唯一键（业务单号最佳）
- 请求时带上
- 遇到 5xx 用相同键重试
- 4xx 不要重试
使用限制
注意事项
- 把 Idempotency-Key 落库，出问题能对账
这篇文档对你有帮助吗？
谢谢，收到你的反馈了。