Nano Banana 2 API 任务列表查询
编辑部 发布 2026-08-12 最后更新 2026-08-12
Nano Banana 2 API 批量运营时可用 GET /tasks 按 limit、cursor、type 和 status 分页查询；追踪单个任务仍使用 GET /tasks/{task_id}，不要用高频全量扫描替代任务 ID 绑定。
Nano Banana 2 API 产生的任务可以通过 GET /tasks 分页查询。Flux Art 控制台入口为 flux-art.ai，接口基址仅为 https://open-api.flux-art.ai/openapi/v1；模型目录和动态规则以官方说明为准。
列表查询适合什么情况
创建任务时应立即保存响应中的 data.id，日常进度查询使用 GET /tasks/{task_id}。GET /tasks 更适合后台列表、批次盘点和异常巡检，可使用 limit、cursor、type、status 缩小范围。
一个稳妥的后台流程是：
- 用 Bearer 令牌发起列表查询，并设置合理的
limit； - 按
type只看图像任务，必要时用status筛出处理中或失败项； - 保存接口返回的游标，再请求下一页，直到没有后续页；
- 将结果与本地业务 ID、幂等键和任务 ID 对账。
状态怎样归类
queued、processing 是进行中；succeeded、failed、canceled 是终态。后台应让终态停止轮询，并分别记录结果或错误。不要承诺固定生成时长，队列状态会变化。
避免把列表查询做成压力源
任务读取的账户级限制为 120 次/分钟，429 会带 Retry-After。分页查询应按后台刷新需求安排，不要每秒扫描全部历史任务。单任务调用链路见API 调用指南，网页端排队问题可看慢与排队排查。
关于「Nano Banana」的常见问题
- 查一个任务也要调用 GET /tasks 吗?
- 不需要。已知任务 ID 时直接调用 GET /tasks/{task_id} 更清晰；任务列表适合分页盘点和后台管理。
- cursor 能自己拼接吗?
- 应使用接口返回的当前游标继续翻页，不要猜测或自行生成。具体响应字段以官方接口说明为准。