Nano Banana 2 API 幂等键怎么用
编辑部 发布 2026-08-24 最后更新 2026-08-28
Nano Banana 2 API 创建任务必须带 8–128 字符的 Idempotency-Key。同一请求超时或遇到 5xx 时沿用原键；参数改变或明确创建新任务时换新键，跨请求复用会返回 409。
Nano Banana 2 接入 Flux Art OpenAPI 创建图像任务时，需要携带 Idempotency-Key。接口基址只有 https://open-api.flux-art.cn/openapi/v1；Key、模型目录和当前计费以官网与控制台为准。
幂等键的使用边界
| 情况 | 应该怎么做 |
|---|---|
| 首次创建任务 | 生成新的 8–128 字符唯一键 |
| 网络超时、连接中断或 5xx | 请求参数不变，并沿用原键重试 |
| 用户明确再次生成 | 换一个新键 |
| prompt、参考图或其他参数改变 | 换一个新键 |
| 返回 409 idempotency_key_reused | 检查是否把同一键用于不同请求 |
允许字符为字母、数字、句点、下划线、冒号和连字符。键值应与业务订单或任务记录绑定，但不要放入邮箱、姓名等个人信息。
怎样避免重复任务
客户端先保存“业务请求—幂等键—返回任务 ID”的映射，再调用创建接口。创建成功后使用返回的任务 ID 查询状态，不要靠不断重复创建来判断结果。完整请求结构见API 调用指南，任务列表恢复方法见任务查询教程。
关于「Nano Banana 2 API 幂等键怎么用」的常见问题
- 请求超时后要生成新幂等键吗?
- 不要。未确认结果的同一请求应沿用原键，避免把一次业务动作创建成两个任务。
- 什么时候必须换新键?
- 当参数改变、用户明确再次生成，或业务上确定是一个新任务时，应使用新的唯一键。
- 出现 409 应该直接重试吗?
- 不应盲目重试。先核对该键是否被不同参数或不同业务请求复用，再按实际业务边界处理。