Nano Banana 2 API 幂等重放说明
编辑部 发布 2026-09-02 最后更新 2026-09-02
Nano Banana 2 API 响应带 Idempotent-Replayed，表示服务端识别到同一 Idempotency-Key 的重放，并返回原请求对应结果。客户端应复用原 task_id，不再创建新任务；只有新的业务请求才换新键。
Nano Banana 2 API 要求创建任务时携带 Idempotency-Key。响应头出现 Idempotent-Replayed，表示服务端把这次调用识别为同一幂等请求的重放，而不是又创建了一份新任务。
客户端应该怎样处理
- 读取响应中的原
task_id； - 把它与业务订单和幂等键绑定；
- 继续查询这个任务，不再重复创建；
- 在监控中记录“幂等重放”，但不要当作失败告警；
- 核对请求体是否确实与原请求一致。
完整的键长、允许字符与 409 边界见幂等键使用指南。
哪些情况沿用原键
网络超时或 5xx 后重试同一业务请求时沿用原键。新的生成、重新生成或已经修改请求内容时换新键；把同一键复用于不同请求会返回 409 idempotency_key_reused。
关于「Nano Banana 2 API 幂等重放说明」的常见问题
- Idempotent-Replayed 是错误吗?
- 不是。它说明这次响应来自同一幂等请求的重放处理。
- 看到该响应头后还要新建任务吗?
- 不要，应保存并继续使用返回的原 task_id。
- 什么时候需要换新的 Idempotency-Key?
- 只有新的业务请求或明确重新生成时才换新键。