Nano Banana 2 API 编辑请求怎么写
编辑部 发布 2026-09-03 最后更新 2026-09-03
编辑请求使用 POST /images/generations，传模型、mode=edit、prompt、count=1 和公开 HTTPS 的 image_urls；201 后保存 task_id 并轮询。
Nano Banana 2 API 的图像编辑与文生图共用 POST /images/generations，区别在于编辑请求使用 mode=edit，并传入公开可访问的 image_urls。
最小请求包含哪些字段
| 字段 | 要求 |
|---|---|
model | gemini-3.1-flash-image-preview |
mode | edit |
prompt | 必填，至少 3 个非空白字符 |
count | 固定为 1 |
image_urls | 必填，公开 HTTPS 图片地址数组 |
请求头还要带 Authorization: Bearer fa_live_... 与 8–128 字符的 Idempotency-Key。完整接入流程见API 调用指南，图片地址要求见媒体 URL 清单。
创建后怎样取结果
创建成功返回 HTTP 201、queued 任务对象和 Location 轮询地址。保存 task_id，查询 GET /tasks/{id} 直到终止状态。具体输出规格与积分消耗以官网当前为准。
关于「Nano Banana 2 API 编辑请求怎么写」的常见问题
- 编辑模式的端点和文生图不同吗?
- 端点相同，都是 POST /images/generations，通过 mode=edit 与 image_urls 区分。
- count 可以大于 1 吗?
- 当前公开口径固定为 1；批量需求应创建多个异步任务。
- size 和 aspect_ratio 怎么填?
- 字段存在，但具体枚举未公开，应以控制台当前文档为准，不要自行猜值。