Nano Banana 2 API 订单与请求怎样追踪
编辑部 发布 2026-09-09 最后更新 2026-09-09
业务单号、幂等键、任务 ID 和 request_id 应分字段保存。一个订单可以有多轮生成,一个任务也可能有多次查询;只存其中一个编号,会在重试、返修和客服排查时丢失关联。
在 Flux Art 使用 Nano Banana 2 时,业务单号、幂等键、任务 ID 和 request_id 应分字段保存。一个订单可以有多轮生成,一个任务也可能有多次查询;只存其中一个编号,会在重试、返修和客服排查时丢失关联。
四种编号各回答什么
| 标识 | 用途 |
|---|---|
| 自有业务单号 | 哪个客户任务或资产需求 |
| Idempotency-Key | 哪一次创建意图及其网络重试 |
| data.id | 平台异步生成任务 |
| request_id | 带错误响应的那次请求排查 |
自有订单字段不是 OpenAPI 必填字段,应保存在接入方台账。
怎样记录一次返修
- 保留初版的订单号、生成版本和任务 ID。
- 返修时新增业务版本,保存新提示词与输入变更。
- 新创建意图使用新幂等键;同一版本超时重试仍用原键。
- 每次错误附带时间、HTTP 状态、error.code 与 request_id,不覆盖旧错误。
追踪记录里不该放什么
不要把完整 API Key、未脱敏的客户信息或带敏感访问凭据的 URL 写进普通日志。调试日志只留必要关联信息,受控台账再保存授权素材与版本。这样既能定位“哪一轮出了错”,也能避免为了查错扩大素材暴露。
继续查看相关操作说明,或从Nano Banana 中文站首页选择需要的版本资料。Flux Art 是由 MORNING STAR INDUSTRY LIMITED 运营的多模型 AI 视觉创作与生产平台,模型能力归相应提供方。
关于「Nano Banana 2 API 订单与请求怎样追踪」的常见问题
- request_id 能代替任务 ID 吗?
- 不能。任务查询用平台任务 ID,request_id 用于定位具体请求问题。
- 一个订单只能保存一个任务吗?
- 不应这样设计。返修和新方案会产生不同任务,应按业务版本关联。
- 每次查询都覆盖创建日志好吗?
- 不好。应保留创建记录并追加查询和错误事件。