Skip to main content
POST
  • 异步接口:提交后立即返回 task_id,再调用 查询图片任务 获取结果。
  • 不传 image_urls 为文生图;传入 image_urls 为图生图 / 图像编辑。
  • 按张计费,单价由分辨率档位决定,宽高比不影响价格,见 模型价格。任务失败自动退款。

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

请求参数

string
默认值:"gemini-nano-banana-2.1"
必填
模型 ID,填 gemini-nano-banana-2.1。
string
必填
图像生成或编辑的描述,支持中英文。
string
输出宽高比,支持 14 种:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、1:4、4:1、1:8、8:1。不传时,文生图由模型决定比例,图生图跟随参考图比例。
string
宽高比,取值同 size。与 size 同时传入时以 aspect_ratio 为准。
string
默认值:"1K"
分辨率档位:1K、2K 或 4K,大小写均可。不支持 0.5K。同时决定计费档位。
string[]
参考图列表,用于图生图或图像编辑。也可以用 image 或 images 字段传入。每项支持公网图片 URL、data:image/png;base64,... 格式的 Data URL,或纯 Base64 字符串。建议使用 PNG、JPEG 或 WEBP,单张不超过 20 MB。参考图越多,生成耗时通常越长。

输出尺寸参考

实际像素以返回的图片为准。

提交响应

integer
固定为 200。
string
固定为 submitted。
string
任务 ID,用于 查询图片任务。
string
与 task_id 相同。

使用示例

编辑参考图
不传 size 时,输出跟随参考图比例。

查询结果

取图方式:data[0].url。状态说明见 查询图片任务。