Nano Banana 2 API 调用指南
编辑部 发布 2026-08-07 最后更新 2026-08-07
调用 Nano Banana 2 API 时，先用 GET /models 核对当前 model ID，再向 /images/generations 提交任务并保存任务 ID，最后轮询 /tasks/{id}；超时或 5xx 重试须复用原幂等键。
Nano Banana 2 API 适合把图片生成接入自己的工具或业务流程。Flux Art OpenAPI 基础地址是 https://open-api.flux-art.ai/openapi/v1；模型目录、价格和动态规格以官网 flux-art.ai 及 flux-art.cn 当前说明为准。
最小调用链路
一条完整链路只有三类请求：
GET /models：查询当前可用模型，确认准备使用的 model ID；POST /images/generations：提交生成任务并取得任务 ID；GET /tasks/{id}：轮询任务状态和最终结果。
所有受保护请求都要使用 Authorization: Bearer <API_KEY>。不要把密钥写进前端代码、公开仓库或日志。
为什么必须先查模型目录
平台模型目录中可见 gemini-3.1-flash-image-preview 等标识，但生产代码应以 GET /models 的当前返回为准，并在上线前核对目标版本。这样可以避免把展示名称、别名和实际 model ID 混为一谈。网页端版本差异可参考Nano Banana 2 与 Pro 对比。
任务状态怎样处理
queued 和 processing 表示仍在执行，继续按合理间隔查询；succeeded 后读取结果；failed 和 canceled 都是终态，应记录错误并停止轮询。不要承诺固定完成时长，队列会受任务和服务状态影响。
超时与重复任务
每次新业务请求使用新的 8–128 字符幂等键。若同一次请求遇到网络超时或 5xx，应复用原键重试；同一幂等键被不同请求复用可能返回冲突。网页端出现排队时，可同时参考慢与排队排查。
关于「Nano Banana」的常见问题
- Nano Banana 2 API 的基础地址是什么?
- Flux Art OpenAPI 基础地址见官方接口说明，具体可用模型应先查询 GET /models。
- 提交后为什么没有立即返回图片?
- 图片生成采用异步任务流程，提交成功后保存任务 ID，再查询 /tasks/{id} 直到进入终态。
- 请求超时能直接换一个幂等键吗?
- 不建议。相同业务请求在超时或 5xx 后重试，应复用原幂等键，避免生成重复任务。
- 模型 ID 可以长期写死吗?
- 应以 GET /models 的当前结果为准；上线前和版本调整后重新核对可用模型目录。