Nano Banana2 图像生成

  • 面向图片生成与参考图生成场景
  • 对外统一走图片异步任务协议
  • 当前正式清晰度支持 1k / 2k / 4k
  • 当前 size 支持 21:9 / 16:9 / 3:2 / 4:3 / 1:1 / 3:4 / 2:3 / 9:16
  • 本页只描述平台正式支持字段,额外兼容字段不构成对外承诺

请求鉴权

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

提交任务接口

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

请求参数

  1. size 支持:21:916:93:24:31:13:42:39:16
  2. 当前额外兼容能力虽然还包含 auto1:4 / 4:1 / 1:8 / 8:10.5K 以及搜索增强参数,但这些能力不属于当前正式对外参数。
  3. resolution 支持:1k2k4k
  4. images 最多支持 14 张,单图也使用数组传入。
  5. official_fallbackgoogle_searchgoogle_image_search 当前不属于正式对外参数,不应写入业务调用。

响应

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

任务查询接口

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

响应

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

使用示例

文生图

图生图

注意事项

  1. 参考图统一使用 images 数组传入。
  2. n 当前仅支持传 1
  3. 当前正式支持比例为 21:916:93:24:31:13:42:39:16
  4. 提交成功后请使用返回的 task_id 轮询任务结果。