Nano Banana 图像生成
- 面向通用图片生成与参考图生成场景
- 对外统一走图片异步任务协议
- 当前正式清晰度支持
1k / 2k / 4k - 当前
size支持auto与1: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,实际图片结果需要通过任务查询接口继续轮询。
请求参数
size支持:auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。size=auto可直接传入;文生图场景会在1:1或16:9间自动处理,图生图场景按实际结果比例返回;如需稳定结果比例,建议显式传具体比例。resolution当前支持:1k、2k、4k。images最多支持14张,单图也使用数组传入。mask_url为协议级可用字段,当前平台控制台模型参数面板不展示时,可直接通过接口传入。
响应
接口受理成功时会返回task_id,参数错误时返回标准错误对象。
任务查询接口
task_id 查询当前任务状态。任务成功后,可从结果对象里读取图片地址。
返回的 asset_url 为平台稳定化后的结果资源地址,不直接暴露底层原始地址。
响应
任务成功后可从works[].asset_url 读取平台稳定化后的结果资源地址。
使用示例
文生图
图生图
局部重绘
注意事项
- 参考图统一使用
images数组传入。 mask_url需要与images一起使用。n当前仅支持传1。- 提交成功后请使用返回的
task_id轮询任务结果。