Nano Banana 2 API 出图端点教程
编辑部 发布 2026-09-04 最后更新 2026-09-04
Nano Banana 2 API 使用 POST /images/generations 创建异步任务。服务端携带 Bearer 密钥和幂等键,提交 model、mode、prompt 与 count=1,再保存任务 ID 并查询状态。
Nano Banana 2 在 Flux Art OpenAPI 中通过 POST /images/generations 创建出图任务。接口基址只有 https://open-api.flux-art.cn/openapi/v1;密钥必须保存在服务端,模型和动态参数以官网当前说明为准。
创建请求最少需要什么
| 项目 | 作用 |
|---|---|
Authorization: Bearer ... | 账户鉴权 |
Idempotency-Key | 防止同一业务动作被重复创建 |
model | 使用 GET /models 当前返回的模型 ID |
mode | generate 或 edit |
prompt | 至少 3 个非空白字符 |
count | 固定为 1 |
edit 模式还需要公开可读取的 HTTPS image_urls。完整字段边界可回到API 调用指南,模型 ID 应按模型目录说明核对。
201 以后怎样接住任务
创建成功只代表任务进入异步队列。应立即持久化 data.id、Location、幂等键、request_id 与业务单号,再查询原任务。不要因为图片尚未返回就换新幂等键重复创建;轮询与终态处理见任务轮询指南。
关于「Nano Banana 2 API 出图端点教程」的常见问题
- 创建成功会直接返回图片吗?
- 不会。201 表示异步任务已创建,通常先处于 queued,仍需查询任务状态。
- model 可以直接写版本昵称吗?
- 不建议。应通过 GET /models 核对当前 model ID,动态目录以官网当前说明为准。
- 一次请求能把 count 改成多张吗?
- 当前 OpenAPI 规则中 count 固定为 1,批量业务应拆成独立任务。