普通文本请求
普通文本首发不承诺自动重放原响应或 exactly-once。请求超时、页面刷新、断流或 SDK 报网络错误,都不能证明上游未执行。
- 保存原传输 ID 与返回的消费 ID。
- 到本人请求查询执行与财务状态。
- 确认未受理且仍需执行时,由应用/用户明确决定重新发起。
模型代码示例关闭 SDK 的自动 POST 重试。不要给所有文本请求统一加 Idempotency-Key,就宣称可以无限安全重放。
明确支持幂等的操作
媒体、订单、预算或合规操作只有在各自合同明确支持时才使用 Idempotency-Key。持久保存原键和原参数,同一操作恢复沿用原键。身份、模型/配置、数量、金额或价格版本改变可能构成冲突;不要生成新随机键绕过 409。
传输 ID、消费 ID 与 provider/task/operation ID 是不同标识,不能互换。费用结算、释放和退款有各自合同,取消界面动作不删除真实用量。
处理原则
| 已知事实 | 建议 |
|---|---|
| 确定未受理 | 修正条件后明确发起新的请求 |
| 已受理、仍在执行 | 查询原请求/任务 |
| 结果未知 | 保留原标识,查询与核对,避免重复执行 |
| 已交付但费用待核对 | 保留输出,查询原账单,不按免费处理 |