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

鉴权

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

请求参数

string
默认值:"gemini-3-pro-image"
必填
模型 ID,填 gemini-3-pro-image。兼容别名 gemini-3-pro-image-preview、nano-banana-pro。
string
必填
图像描述,支持中英文。需要在图中渲染文字时,把文字内容用引号标出效果更好。
string
输出宽高比:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。不传时,文生图由模型决定比例,图生图跟随参考图比例。建议显式指定。
string
宽高比,取值同 size。与 size 同时传入时以 aspect_ratio 为准。
string
默认值:"1K"
分辨率档位:1K、2K 或 4K,大小写均可。同时决定计费档位。
string[]
参考图列表,用于图生图或图像编辑。也可以用 image 或 images 字段传入。

提交响应

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

使用示例

图像编辑
多图融合

查询结果

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