Nano Banana 2 API 5xx 重试方法
编辑部 发布 2026-08-28 最后更新 2026-08-28
Nano Banana 2 API 遇到 5xx 时，应保持请求参数不变并沿用原 Idempotency-Key 做指数退避。重试前先检查是否已有任务 ID；持续失败时停止自动请求并保存 request_id。
Nano Banana 2 接入 Flux Art OpenAPI 后，internal_error 与 service_unavailable 属于可按边界重试的 5xx。接口基址只有 https://open-api.flux-art.cn/openapi/v1，当前规则以官网与控制台为准。
重试前先检查什么
先确认响应中是否已有任务 ID。若任务已经创建，应查询原任务，而不是再次提交。若创建结果不确定，则保存错误上下文，并保证 prompt、参考图与其他参数不变。
怎样避免重复扣费或重复任务
同一次业务动作在超时或 5xx 后沿用原 Idempotency-Key；立即换键会把调用变成新请求。幂等边界见幂等键说明，任务恢复见任务列表教程。
指数退避不是无限重试。应设置最大次数或总时长，持续失败时保存 request_id、时间和脱敏参数后转人工排查。
关于「Nano Banana 2 API 5xx 重试方法」的常见问题
- 5xx 重试要换 Idempotency-Key 吗?
- 同一业务请求不换；参数变化或明确的新任务才使用新键。
- 所有错误都适合自动重试吗?
- 不适合。参数、鉴权、余额和媒体地址错误应先修正原因。
- 持续 5xx 时要记录什么?
- 记录时间、error.code、request_id、任务 ID 和脱敏请求摘要，不记录完整密钥。