Nano Banana 2 API 任务轮询指南
编辑部 发布 2026-09-04 最后更新 2026-09-04
创建返回 201、queued 和 task_id 后，查询 GET /tasks/{id}。前两种状态继续等待，三种终态停止；读取限流为账户级 120 次/分钟。
Nano Banana 2 API 是异步任务模式。创建成功返回 HTTP 201、queued 状态、task_id 与 Location，客户端随后查询 GET /tasks/{id}。
状态机怎样写
| 状态 | 动作 |
|---|---|
queued、processing | 等待后继续查询 |
succeeded | 保存结果并停止 |
failed | 保存错误与 request_id 并停止 |
canceled | 保存终态并停止 |
不要把轮询超时直接等同于任务失败，也不要因为客户端暂时没收到结果就重建任务。五种状态的业务动作见任务状态说明。
怎样控制读取频率
任务读取限流为账户级 120 次/分钟。建议使用逐步退避和少量抖动，收到 429 时按 Retry-After 等待。把 task_id 持久化；服务重启后可从记录恢复，或用任务列表接口找回在途任务。
关于「Nano Banana 2 API 任务轮询指南」的常见问题
- 创建成功后为什么没有立即返回图片?
- OpenAPI 使用异步任务，201 表示任务已创建并进入 queued，不等于结果已经生成。
- 轮询频率可以固定得很高吗?
- 不建议。任务读取限流为账户级 120 次/分钟，应退避并遵循 Retry-After。
- 服务重启后如何恢复轮询?
- 从持久化 task_id 恢复；若本地映射缺失，可用 GET /tasks 分页查询在途任务。