Skip to content

Gemini API / IMAGE GENERATION

用 Gemini API 生成图片。

从文字生成开始,继续探索图片编辑、多轮修改、参考图和高分辨率输出。

查看 Google 官方文档
Gemini 图片生成 API 官方示意图
图片来源:Google Gemini API 官方文档
01

选择图片模型

Nano Banana 是 Gemini 原生图片生成功能的名称。当前常用模型包括 Nano Banana 2、Nano Banana 2 Lite 和 Nano Banana Pro。

Nano Banana 2通用图片生成和编辑,平衡速度、智能与质量。
Nano Banana 2 Lite超低延迟且成本友好,适合规模化交互。
Nano Banana Pro复杂视觉任务、专业素材和最高 4K 输出。
02

文字生成图片

使用 Gemini 3.1 Flash Image,根据文字提示创建图片。所有生成图片都包含 SynthID 水印。

Python
from google import genai
import base64

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="一张极简的蓝色工作台照片,柔和自然光,16:9。",
)

with open("generated.png", "wb") as image_file:
    image_file.write(base64.b64decode(interaction.output_image.data))
03

图片编辑与多轮修改

把图片和文字提示放在同一条输入中,可以添加、删除、替换元素或改变风格。继续使用 previous_interaction_id,可以用对话方式逐轮优化结果。

Gemini 生成的产品摄影示例
官方示例:根据提示生成产品摄影图
Python
with open("product.png", "rb") as image_file:
    image_data = base64.b64encode(image_file.read()).decode("utf-8")

interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input=[
        {"type": "text", "text": "把背景换成浅灰色,保留产品细节。"},
        {"type": "image", "data": image_data, "mime_type": "image/png"},
    ],
)
04

分辨率与宽高比

在 response_format 中设置 aspect_ratio 和 image_size。Gemini 3 图片模型支持 1K、2K 和 4K,Nano Banana 2 Lite 仅支持 1K。

Python
interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="生成一张产品海报。",
    response_format={
        "type": "image",
        "aspect_ratio": "16:9",
        "image_size": "2K",
    },
)
图片生成支持 1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9 和 21:9 等常用比例。
05

提示词写法

描述主体、场景、光线、镜头和用途。与其写“生成一张好看的产品图”,不如写清楚产品、材质、背景、构图和输出比例。

逼真场景

一张逼真的广角照片,主体是一个放在深色桌面上的蓝色玻璃杯,柔和侧光,16:9。

产品摄影

棚拍风格的商品照片,产品位于画面中央,浅灰背景,三点布光,突出材质细节。

风格化插图

扁平插画风格的城市地图,使用高对比蓝绿色,清晰标注三个地点,不添加多余文字。

06

使用限制

  • 请确保对上传的图片拥有必要权利,不要生成侵犯他人权利或造成伤害的内容。
  • 图片生成不支持音频输入,视频输入仅适用于 Gemini 3.1 Flash Image 和 Gemini 3.1 Flash Lite Image。
  • 模型不一定会生成你明确要求的确切图片数量。
  • 生成结果和模型能力会变化,生产环境请固定稳定模型并关注官方弃用通知。

下一步

Last updated:

信息仅作入口导航,使用前请确认服务条款与隐私政策。