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

鉴权

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

请求参数

string
默认值:"gemini-3.1-flash-image"
必填
模型 ID,填 gemini-3.1-flash-image。兼容别名 gemini-3.1-flash-image-preview。
string
必填
图像描述,支持中英文。
string
输出宽高比:不传时,文生图由模型决定比例,图生图跟随参考图比例。
string
宽高比,取值同 size。与 size 同时传入时以 aspect_ratio 为准。
string
默认值:"1K"
分辨率档位:1K(约 1024px)、2K(约 2048px)或 4K(约 4096px),大小写均可。同时决定计费档位。
string[]
参考图列表,用于图生图或图像编辑。也可以用 image 或 images 字段传入。

提交响应

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

使用示例

超长竖图
角色一致性

查询结果

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