Nano Banana 图像生成

  • 面向通用图片生成与参考图生成场景
  • 对外统一走图片异步任务协议
  • 当前正式清晰度支持 1k / 2k / 4k
  • 当前 size 支持 auto1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9

请求鉴权

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

提交任务接口

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

请求参数

  1. size 支持:auto1:12:33:23:44:34:55:49:1616:921:9
  2. size=auto 可直接传入;文生图场景会在 1:116:9 间自动处理,图生图场景按实际结果比例返回;如需稳定结果比例,建议显式传具体比例。
  3. resolution 当前支持:1k2k4k
  4. images 最多支持 14 张,单图也使用数组传入。
  5. mask_url 为协议级可用字段,当前平台控制台模型参数面板不展示时,可直接通过接口传入。

响应

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

任务查询接口

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

响应

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

使用示例

文生图

图生图

局部重绘

注意事项

  1. 参考图统一使用 images 数组传入。
  2. mask_url 需要与 images 一起使用。
  3. n 当前仅支持传 1
  4. 提交成功后请使用返回的 task_id 轮询任务结果。