Gemini 3.1 Flash Image — 从 512px 到 4K 的快速生图
Gemini 3.1 Flash Image 是 Google 的通用图像模型:从 512px 草图到 4K 成品,14 种宽高比,支持图像、视频和 PDF 参考。沿用你的 generateContent 请求体即可。每张 $0.03 起。
- 文生图
- 图像编辑
- 512px 到 4K
- 14 种宽高比
- 最多 14 张参考图
- 支持视频与 PDF 输入
写代码之前,先试试 Gemini 3.1 Flash Image
用你的代码将要发送的同一份 JSON 运行 Gemini 3.1 Flash Image。该接口支持的每个 generateContent 字段都在这里。
gemini-3.1-flash-image-official$45.00 / 1M image output tokens
描述你想要的图像,有参考图就一并加上,提交一次即可。任务完成后结果就会显示。
要生成或修改什么。主体、场景、光线和风格。
需要模型读取的图像、视频或 PDF。文件会先上传,再以 URL 形式发送。
最多 14 张,以 fileData URL 发送。
默认跟随第一张参考图,没有参考图时为 1:1。
输出分辨率,默认 1K。
只返回图像,或图像加一段简短文字回复。
给模型的固定规则,例如统一的品牌风格。
该类别的拦截阈值。
灰色选项会放宽内容过滤,只能通过 API 使用,Playground 中不可选。
该类别的拦截阈值。
灰色选项会放宽内容过滤,只能通过 API 使用,Playground 中不可选。
该类别的拦截阈值。
灰色选项会放宽内容过滤,只能通过 API 使用,Playground 中不可选。
该类别的拦截阈值。
灰色选项会放宽内容过滤,只能通过 API 使用,Playground 中不可选。
0–2。留空则使用模型默认值。
0–1。留空则使用模型默认值。
整数,不小于 1。
整数。重复使用同一个值,可以更接近地复现结果。
限制文本与思考输出的上限。
每行一个,最多 5 个。
只能为 1:一次请求返回一张图像。
每张参考图消耗多少 token。越低越便宜。
随图像一起返回模型的思考摘要。
IMAGE_JPEG 是文档中唯一列出的取值。
仅当上方的宽高比为「默认」时生效;两者都设置时以宽高比为准。
仅当上方的图像尺寸为「默认」时生效;两者都设置时以图像尺寸为准。
按当前费率预估:所选尺寸的图像 token,加上一份实测的文本与思考 token 样本。在 Official 渠道上,参考图输入会让费用略有增加。

试试下面这几条提示词



通过本 API 使用 Gemini 3.1 Flash Image 生成的示例图
Gemini 3.1 Flash Image API 价格
Gemini 3.1 Flash Image 有两种计费方式。Standard 按张计费,任何尺寸同一个价;Official 按每次渲染报告的 token 计费,所以小图更便宜,4K 更贵。
- Official
- $0.05132/张
- Standard
- $0.03/张
- Official
- 389张
- Standard
- 666张
两种价格都来自对你账户实际计费的费率。失败的请求不扣费。
Official 的预估使用 Google 公布的各尺寸图像 token 数,再加上一份实测样本:405 个文本与思考 token,以及 27 个提示词 token。
Gemini 3.1 Flash Image 各尺寸价格
Google 公布了 Gemini 3.1 Flash Image 各尺寸的图像 token 数,从 512px 的 747 到 4K 的 2,520。下面的 Official 价格另加了一份实测的文本与思考样本。
| 图像尺寸 | 图像 token | 价格 · Official | 价格 · Standard |
|---|---|---|---|
| 512 | 747 | $0.03454 | $0.03 |
| 1K | 1,120 | $0.05132 | $0.03 |
| 2K | 1,680 | $0.07652 | $0.03 |
| 4K | 2,520 | $0.11432 | $0.03 |
Standard 每张图一个固定价,所有尺寸都一样。Official 跟随图像 token,尺寸越大越贵。
估算你自己的 Gemini 3.1 Flash Image 请求价格
选一个尺寸,看数字怎么变。它由实时费率和 Google 公布的各尺寸图像 token 数算出,价格一变它也跟着变。
这是提交前的预估。Standard 按交付的每张图计费;Official 对图像输出、文本与思考输出、输入分别按各自费率计费。
| 项目 | 计量方式 | 费率 | 计费 |
|---|---|---|---|
| Official · 图像输出 | 本次渲染报告的图像 token | $45.00 / 1M$60.00 / 1M | 按实际用量扣费 |
| Official · 文本与思考输出 | 本次渲染报告的文本与思考 token | $2.25 / 1M$3.00 / 1M | 按实际用量扣费 |
| Official · 输入 | 提示词与参考图 token | $0.375 / 1M$0.50 / 1M | 按实际用量扣费 |
| Standard · 按张计费 | 每交付一张图,任何尺寸 | $0.03 /张$0.04 /张 | 图像交付时扣费 |
| 失败的请求 | 任何以失败结束的任务 | 免费 | 不扣任何费用 |
Gemini 3.1 Flash Image 是什么?
Gemini 3.1 Flash Image 是 Google 的图像生成与编辑模型,产品名为 Nano Banana 2。Google 称它是自家最全能的图像模型,在速度与 4K 输出、世界知识和可靠的文字渲染之间取得平衡。
在 SeedRouter 上,你用 Google 自己的 generateContent 请求体加一个 model 字段来调用 Gemini 3.1 Flash Image。提交一次,保存任务 ID,任务完成后读取托管的图像 URL。
模型 ID:gemini-3.1-flash-image · 按 token 计费 ID:gemini-3.1-flash-image-official · 输入上限:131,072 token。
使用 Gemini 3.1 Flash Image 的两种方式
从你的后端调用 API,或者把活交给编程 Agent。
调用 API
从你的服务器发送 Gemini 3.1 Flash Image 请求,保存任务 ID,再从任务中读取成品图。
- 1创建 API key
- 2POST 请求体
- 3轮询任务直到完成
交给 Agent 来做
把现成的提示词复制到 Claude Code、Codex 或 Cursor。它会在花钱前先征求你同意,并自动下载结果。
- 1复制提示词
- 2填上你想要的内容
- 3批准这次请求
开发者为什么选 Gemini 3.1 Flash Image
默认的 Gemini 图像模型:出图快、灵活,打草稿成本低。
Google 的请求体
Gemini 3.1 Flash Image 接受的 contents 和 generationConfig,与你发给 Google 的完全一样。加一个 model 字段就行了。
四种输出尺寸
用同一个 Gemini 3.1 Flash Image 请求,以 512px 起草,以 4K 定稿。
极端宽高比
Gemini 3.1 Flash Image 新增 1:4、4:1、1:8 和 8:1,适合横幅和竖长画幅。
视频与 PDF 参考
交给 Gemini 3.1 Flash Image 的不只是照片,也可以是一段视频或一份产品规格单。
14 张参考图
在一次 Gemini 3.1 Flash Image 请求中组合最多 14 张参考,以 fileData URL 传入。
基于任务
Gemini 3.1 Flash Image 渲染绝不会一直占着你的连接。你轮询任务,拿到 URL。
团队都用 Gemini 3.1 Flash Image 做什么
商品目录图
Gemini 3.1 Flash Image 能批量整理、美化商品照片。
社媒画幅
一条提示词,生成方形、竖版和宽幅的 Gemini 3.1 Flash Image 多个版本。
横幅
Gemini 3.1 Flash Image 能直接填满 8:1 和 1:8 版式,无需裁切。
低成本草图
用 Gemini 3.1 Flash Image 以 512px 迭代,再把定稿的那张渲染成 4K。
从文档生成
用 Gemini 3.1 Flash Image 把一份 PDF 需求简报变成视觉图。
编辑
用 Gemini 3.1 Flash Image 更换背景、颜色或某个物体,其余保持不变。
四步上手 Gemini 3.1 Flash Image
- 01
创建一把 key
登录,充值任意金额,然后创建一把 API Key。额度永不过期。
- 02
发送一次请求
把带有提示词和参考图 URL 的 Gemini 3.1 Flash Image 请求体 POST 到 /v1/images/generations。
- 03
轮询任务
保存任务 ID,每隔几秒查询一次,直到状态变为 completed。
- 04
下载图像
把任务输出里的托管图像 URL 保存到你自己的存储。
Gemini 3.1 Flash Image 一览
判断 Gemini 3.1 Flash Image 是否适合你的任务,看这几项就够了。
| 特性 | Gemini 3.1 Flash Image |
|---|---|
| 模型 ID | gemini-3.1-flash-image |
| 输出尺寸 | 512、1K、2K、4K |
| 宽高比 | 14 种(1:8 到 8:1) |
| 参考图 | 最多 14 张 |
| 参考类型 | 图像、视频、PDF |
| 计费 | 按张计费(Standard)或按 token 计费(Official) |
最复杂的视觉任务请看 Gemini 3 Pro Image;想要最低成本的 1K 出图,请看 Gemini 3.1 Flash Lite Image。
迁移 Gemini 3.1 Flash Image 代码之前
preview ID 仍然可用
Google 已于 2026 年 6 月 25 日下线 gemini-3.1-flash-image-preview。在这里它仍能运行,由 gemini-3.1-flash-image 提供服务。
用 URL,不用 inlineData
Gemini 3.1 Flash Image 的参考图请以 fileData URL 发送。Base64 的 inlineData 会在扣费之前被拒绝。
暂不支持 Search grounding
带 tools 的 Gemini 3.1 Flash Image 请求目前会被拒绝。
每次请求一张图
candidateCount 为 1。需要多张时,发送多个 Gemini 3.1 Flash Image 请求。
为什么在 SeedRouter 上用 Gemini 3.1 Flash Image
两种付费方式
选 Standard,每张 Gemini 3.1 Flash Image 图一个固定价;选 Official,按每次渲染报告的 token 付费。同一把 key,同一个请求体。
失败的请求不收费
任务以失败结束时不扣任何费用。你只为成功交付的图像付费。
额度永不过期
充值一次,随时使用余额。无需订阅。
托管结果
成品图以我们 CDN 上的 URL 返回。需要长期保存的内容,请自行备份一份。
一把 key 调用所有模型
同一把 key 和余额也可用于目录中的其他图像模型。
SeedRouter 上的其他图像模型
同一把 key、同一份余额、同一套任务 API。
在 SeedRouter 上用 GPT Image 2 生成和编辑图像。支持文本提示词、参考图与透明背景,配有在线 Playground,按用量计费。
查看价格在 SeedRouter 上用 GPT Image 2.5 Flare 或 Sunburst 生成和编辑图像。六档质量最高到 max,支持透明背景,配有在线 Playground,按用量计费。
查看价格用 Google 的 generateContent 请求体调用 Gemini 3 Pro Image(gemini-3-pro-image):1K 到 4K、内置思考、14 张参考图,按次或按 token 计费。
查看价格用 generateContent 请求体调用 Gemini 3.1 Flash Lite Image(gemini-3.1-flash-lite-image),Google 最快、最便宜的图像模型,1K 输出。
查看价格Gemini 3.1 Flash Image 使用教程
关于如何选型、计价和接入这个模型的实用指南。
Nano Banana 免费吗?不付费时 Gemini 应用和 Gemini API 对 Nano Banana 2 与 Nano Banana Pro 分别提供什么,以及从什么时候开始收费。
一步步调用 Nano Banana 2 API:创建 API Key、发送 generateContent 请求、轮询任务、添加参考图,以及交给编程 Agent 执行。
从输出尺寸、宽高比、参考图、思考能力和计费方式对比 Nano Banana 2、Nano Banana Pro 与 Nano Banana 2 Lite,按任务选对模型。
Nano Banana 2、Pro 和 2 Lite 的 API 当前价格:按张固定价与按 token 计费,不同分辨率的单图成本,以及各计费方式适合的场景。
Gemini 3.1 Flash Image 常见问题
Gemini 3.1 Flash Image 和 Nano Banana 2 是同一个模型吗?+
是的。Nano Banana 2 是 Google 给 Gemini 3.1 Flash Image 起的产品名,模型 ID 为 gemini-3.1-flash-image。Nano Banana 2 页面从产品角度介绍的是同一个模型。
有 Gemini 3 Flash Image 吗?+
没有。Gemini 3 系列中的 Flash 图像模型就是 Gemini 3.1 Flash Image,模型 ID 为 gemini-3.1-flash-image。搜索 Gemini 3 Flash Image 的人,通常找的就是这个模型。
gemini-3.1-flash-image-preview 还能用吗?+
Google 已于 2026 年 6 月 25 日关停该 preview ID。在 SeedRouter 上 gemini-3.1-flash-image-preview 仍被接受,并运行在 gemini-3.1-flash-image 上,所以你在切换 ID 期间旧代码照样能跑。
Gemini 3.1 Flash Image 多少钱一张?+
在 Standard 渠道,一张 1K 图 $0.03,与提示词无关。在 Official 渠道,按每次渲染报告的 token 付费,一次典型的 1K 渲染约 $0.05132。价格部分按实时费率列出了每个尺寸的价格。
Gemini 3.1 Flash Image 免费吗?+
Google 的价格页面没有为 Gemini API 上的 Gemini 3.1 Flash Image 列出免费层级。在 SeedRouter 上充值一次,额度永不过期,失败的请求不扣费。
我需要修改 Gemini 请求吗?+
contents、systemInstruction、safetySettings 和 generationConfig 保持原样即可。加一个 model 字段,发送到 /v1/images/generations,再从任务中读取 Gemini 3.1 Flash Image 的结果。
怎么获取 Gemini 3.1 Flash Image 的 API Key?+
登录,充值任意金额,然后在 API Key 页面创建一把 key。同一把 key 可以调用 Gemini 3.1 Flash Image 和这里的所有其他模型。
Gemini 3.1 Flash Image 和 Gemini 3 Pro Image 该选哪个?+
追求速度、512px 草图、极端宽高比以及视频或 PDF 参考,先从 Gemini 3.1 Flash Image 开始。遇到复杂指令和专业素材,再换用 Gemini 3 Pro Image。
发送你的第一个 Gemini 3.1 Flash Image 请求
先在 Playground 里试用 Gemini 3.1 Flash Image,再把同一份 JSON 粘贴进你的代码。
