Gemini 生图模型调用教程

本文档介绍通过中转 API 调用 Gemini 系列生图模型的 Python 示例代码，支持文字生图和参考图生图两种方式。

环境准备

一、可用模型

模型名	特点
`gemini-2.5-flash-image`	速度快，适合快速出图
`gemini-3.1-flash-image-preview`	画质更高，支持 2K 分辨率
`gemini-3-pro-image-preview`	旗舰生图模型，支持参考图融合

二、调用方式说明

Gemini 生图模型支持两种调用格式：

OpenAI 兼容格式：结构简单，与 GPT 调用方式一致，适合快速接入

Gemini 原生格式：支持更多参数（比例、分辨率等），功能更完整

三、OpenAI 兼容格式调用

适用模型：gemini-2.5-flash-image、gemini-3-pro-image-preview

在 prompt 中用文字描述所需图片比例（如"图片比例16:9"），返回图片以 base64 编码内嵌在响应中。

gemini-2.5-flash-image

gemini-3-pro-image-preview

四、Gemini 原生格式调用

支持精确设置图片比例（aspectRatio）和分辨率（imageSize）参数

参数说明

参数	可选值	说明
`aspectRatio`	`1:1` `16:9` `9:16` `4:3` `3:4`	图片比例
`imageSize`	`1K` `2K` `4K`	图片分辨率（部分模型支持）

gemini-2.5-flash-image（原生格式）

gemini-3.1-flash-image-preview（原生格式）

五、参考图生图（图生图）

适用模型：gemini-3-pro-image-preview
上传一张或多张参考图，让模型融合参考图的风格、主体或场景生成新图片。

六、注意事项

将代码中的 sk-xxx 替换为你自己的 API Key

生图请求耗时较长，建议设置 timeout=300（5分钟）

参考图生图时，图片描述越详细，融合效果越好

如需单张参考图，删除 parts 中的第二个 inlineData 即可

环境准备#

一、可用模型#

二、调用方式说明#

三、OpenAI 兼容格式调用#

gemini-2.5-flash-image#

gemini-3-pro-image-preview#

四、Gemini 原生格式调用#

参数说明#

gemini-2.5-flash-image（原生格式）#

gemini-3.1-flash-image-preview（原生格式）#

五、参考图生图（图生图）#

六、注意事项#