跳至主要内容

重试、幂等与未知结果

按接口决定能否重发,避免重复产生付费操作。

普通文本请求

普通文本首发不承诺自动重放原响应或 exactly-once。请求超时、页面刷新、断流或 SDK 报网络错误,都不能证明上游未执行。

  1. 保存原传输 ID 与返回的消费 ID。
  2. 到本人请求查询执行与财务状态。
  3. 确认未受理且仍需执行时,由应用/用户明确决定重新发起。

模型代码示例关闭 SDK 的自动 POST 重试。不要给所有文本请求统一加 Idempotency-Key,就宣称可以无限安全重放。

明确支持幂等的操作

媒体、订单、预算或合规操作只有在各自合同明确支持时才使用 Idempotency-Key。持久保存原键和原参数,同一操作恢复沿用原键。身份、模型/配置、数量、金额或价格版本改变可能构成冲突;不要生成新随机键绕过 409。

传输 ID、消费 ID 与 provider/task/operation ID 是不同标识,不能互换。费用结算、释放和退款有各自合同,取消界面动作不删除真实用量。

处理原则

已知事实建议
确定未受理修正条件后明确发起新的请求
已受理、仍在执行查询原请求/任务
结果未知保留原标识,查询与核对,避免重复执行
已交付但费用待核对保留输出,查询原账单,不按免费处理

错误处理 · 流式响应 · 用量与费用