Nano Banana Pro 图像生成

  • 面向更高规格的图片生成与参考图生成场景
  • 对外统一走图片异步任务协议
  • 当前 size 支持 auto1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
  • 当前 resolution 支持 1k / 2k / 4k
  • 本页只描述当前已确认的对外协议字段,不展开具体实现差异

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。 获取 API Key:从平台上获取。 使用时在请求头中添加:

提交任务接口

提交图片异步任务。接口受理成功后会立即返回 task_id,实际图片结果需要通过任务查询接口继续轮询。

请求参数

  1. size 支持:auto1:12:33:23:44:34:55:49:1616:921:9
  2. size=auto 时,当前请求会按现有协议直接透传;如需稳定结果比例,建议显式传具体比例。
  3. resolution 支持:1k2k4k
  4. images 最多支持 14 张,单图也使用数组传入。

响应

接口受理成功时会返回 task_id,参数错误时返回标准错误对象。

任务查询接口

使用提交阶段返回的 task_id 查询当前任务状态。任务成功后,可从结果对象里读取图片地址。 返回的 asset_url 为平台稳定化后的结果资源地址,不直接暴露底层原始地址。

响应

任务成功后可从 works[].asset_url 读取平台稳定化后的结果资源地址。

使用示例

文生图

图生图

注意事项

  1. 参考图统一使用 images 数组传入。
  2. n 当前仅支持传 1
  3. 当前正式支持比例为 auto1:12:33:23:44:34:55:49:1616:921:9
  4. 当前文档未开放 mask_urlofficial_fallback
  5. 提交成功后请使用返回的 task_id 轮询任务结果。