Gemini 3 Pro Image — Google 的高端图像模型，一次 API 调用即可用
Gemini 3 Pro Image 是 Google 面向专业图像工作的模型：1K 到 4K 输出，内置思考，最多 14 张参考图。直接发送你熟悉的 generateContent 请求体。每张 $0.03 起。
- 文生图
- 图像编辑
- 1K 到 4K
- 内置思考
- 最多 14 张参考图
- generateContent 请求体
写代码之前，先试试 Gemini 3 Pro Image
用你的代码将要发送的同一份 JSON 运行 Gemini 3 Pro Image。该接口支持的每个 generateContent 字段都在这里。
gemini-3-pro-image-official$90.00 / 1M image output tokens
描述你想要的图像，有参考图就一并加上，提交一次即可。任务完成后结果就会显示。
要生成或修改什么。主体、场景、光线和风格。
模型需要参照的参考图。文件会先上传，再以 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 Pro Image 生成的示例图
Gemini 3 Pro Image API 价格
Gemini 3 Pro Image 有两种计费方式。Standard 按张计费，任何尺寸同一个价；Official 按每次渲染报告的 token 计费，其中 1K 和 2K 价格相同，4K 更贵。
- Official
- $0.10304/张
- Standard
- $0.03/张
- Official
- 194张
- Standard
- 666张
两种价格都来自对你账户实际计费的费率。失败的请求不扣费。
Official 的预估使用 Google 公布的各尺寸图像 token 数，再加上一份实测样本：246 个文本与思考 token，以及 14 个提示词 token。
Gemini 3 Pro Image 各尺寸价格
Google 公布了 Gemini 3 Pro Image 各尺寸的图像 token 数：1K 和 2K 为 1,120，4K 为 2,000。下面的 Official 价格另加了一份实测的思考样本。
| 图像尺寸 | 图像 token | 价格 · Official | 价格 · Standard |
|---|---|---|---|
| 1K | 1,120 | $0.10304 | $0.03 |
| 2K | 1,120 | $0.10304 | $0.03 |
| 4K | 2,000 | $0.18224 | $0.03 |
Standard 每张图一个固定价，所有尺寸都一样。Official 跟随图像 token，尺寸越大越贵。
估算你自己的 Gemini 3 Pro Image 请求价格
选一个尺寸，看数字怎么变。它由实时费率和 Google 公布的各尺寸图像 token 数算出，价格一变它也跟着变。
这是提交前的预估。Standard 按交付的每张图计费；Official 对图像输出、文本与思考输出、输入分别按各自费率计费。
| 项目 | 计量方式 | 费率 | 计费 |
|---|---|---|---|
| Official · 图像输出 | 本次渲染报告的图像 token | $90.00 / 1M$120.00 / 1M | 按实际用量扣费 |
| Official · 文本与思考输出 | 本次渲染报告的文本与思考 token | $9.00 / 1M$12.00 / 1M | 按实际用量扣费 |
| Official · 输入 | 提示词与参考图 token | $1.50 / 1M$2.00 / 1M | 按实际用量扣费 |
| Standard · 按张计费 | 每交付一张图，任何尺寸 | $0.03 /张$0.04 /张 | 图像交付时扣费 |
| 失败的请求 | 任何以失败结束的任务 | 免费 | 不扣任何费用 |
Gemini 3 Pro Image 是什么？
Gemini 3 Pro Image 是 Google 的图像生成与编辑模型，产品名为 Nano Banana Pro。Google 称它是应对最复杂视觉任务的高端之选，专为专业素材制作而设计。
在 SeedRouter 上，你用 Google 自己的 generateContent 请求体加一个 model 字段来调用 Gemini 3 Pro Image。提交一次，保存任务 ID，任务完成后读取托管的图像 URL。
模型 ID：gemini-3-pro-image · 按 token 计费 ID：gemini-3-pro-image-official · 输入上限：65,536 token。
使用 Gemini 3 Pro Image 的两种方式
从你的后端调用 API，或者把活交给编程 Agent。
调用 API
从你的服务器发送 Gemini 3 Pro Image 请求，保存任务 ID，再从任务中读取成品图。
- 1创建 API key
- 2POST 请求体
- 3轮询任务直到完成
交给 Agent 来做
把现成的提示词复制到 Claude Code、Codex 或 Cursor。它会在花钱前先征求你同意，并自动下载结果。
- 1复制提示词
- 2填上你想要的内容
- 3批准这次请求
开发者为什么选 Gemini 3 Pro Image
当一次渲染必须把复杂指令做对时，就用这个 Gemini 模型。
Google 的请求体
Gemini 3 Pro Image 接受的 contents 和 generationConfig，与你发给 Google 的完全一样。加一个 model 字段就行了。
先思考，再动笔
Gemini 3 Pro Image 会先推理布局。想知道原因时，用 includeThoughts 请求返回思考摘要。
文字清晰可读
Google 把信息图、菜单和图表中清晰、有设计感的文字列为其 Gemini 3 图像模型的强项之一。
4K 输出
Gemini 3 Pro Image 可渲染 1K、2K 和 4K。按 token 计费时，2K 与 1K 价格相同。
14 张参考图
在一次 Gemini 3 Pro Image 请求中组合最多 14 张参考图，以 fileData URL 传入。
基于任务
耗时较长的 Gemini 3 Pro Image 渲染绝不会一直占着你的连接。你轮询任务，拿到 URL。
团队都用 Gemini 3 Pro Image 做什么
信息图与图表
Gemini 3 Pro Image 能把笔记变成带标注的讲解图。
品牌一致的整套素材
Google 把准确的品牌一致性列为 Gemini 3 Pro Image 的强项之一，很适合制作整套营销素材。
印刷作品
用 Gemini 3 Pro Image 生成 4K 海报和包装。
本地化素材
Google 强调了先进的本地化能力，因此一张 Gemini 3 Pro Image 设计可以承载多种语言的文字。
商品场景
把参考照片中的商品放进 Gemini 3 Pro Image 生成的新场景。
精准编辑
用 Gemini 3 Pro Image 只改图像中的一个元素，其余保持不变。
四步上手 Gemini 3 Pro Image
- 01
创建一把 key
登录，充值任意金额，然后创建一把 API Key。额度永不过期。
- 02
发送一次请求
把带有提示词和参考图 URL 的 Gemini 3 Pro Image 请求体 POST 到 /v1/images/generations。
- 03
轮询任务
保存任务 ID，每隔几秒查询一次，直到状态变为 completed。
- 04
下载图像
把任务输出里的托管图像 URL 保存到你自己的存储。
Gemini 3 Pro Image 一览
判断 Gemini 3 Pro Image 是否适合你的任务，看这几项就够了。
| 特性 | Gemini 3 Pro Image |
|---|---|
| 模型 ID | gemini-3-pro-image |
| 输出尺寸 | 1K、2K、4K |
| 宽高比 | 10 种（9:16 到 21:9） |
| 参考图 | 最多 14 张图 |
| 思考 | 始终开启；可选返回思考摘要 |
| 计费 | 按张计费（Standard）或按 token 计费（Official） |
需要 512px 草图、极端宽高比或视频输入？请看 Gemini 3.1 Flash Image。
迁移 Gemini 3 Pro Image 代码之前
preview ID 仍然可用
Google 已于 2026 年 6 月 25 日下线 gemini-3-pro-image-preview。在这里它仍能运行，由 gemini-3-pro-image 提供服务。
用 URL，不用 inlineData
Gemini 3 Pro Image 的参考图请以 fileData URL 发送。Base64 的 inlineData 会在扣费之前被拒绝。
暂不支持 Search grounding
带 tools 的 Gemini 3 Pro Image 请求目前会被拒绝。
每次请求一张图
candidateCount 为 1。需要多张时，发送多个 Gemini 3 Pro Image 请求。
为什么在 SeedRouter 上用 Gemini 3 Pro Image
两种付费方式
选 Standard，每张 Gemini 3 Pro 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.1 Flash Image（gemini-3.1-flash-image）：512px 到 4K、14 种宽高比、14 张参考图，按张计费。
查看价格用 generateContent 请求体调用 Gemini 3.1 Flash Lite Image（gemini-3.1-flash-lite-image），Google 最快、最便宜的图像模型，1K 输出。
查看价格Gemini 3 Pro 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 Pro Image 常见问题
Gemini 3 Pro Image 和 Nano Banana Pro 是同一个模型吗？+
是的。Nano Banana Pro 是 Google 给 Gemini 3 Pro Image 起的产品名，模型 ID 为 gemini-3-pro-image。Nano Banana Pro 页面从产品角度介绍的是同一个模型。
gemini-3-pro-image-preview 还能用吗？+
Google 已于 2026 年 6 月 25 日关停该 preview ID。在 SeedRouter 上 gemini-3-pro-image-preview 仍被接受，并运行在 gemini-3-pro-image 上，所以你在切换 ID 期间旧代码照样能跑。
Gemini 3 Pro Image 多少钱一张？+
在 Standard 渠道，一张图 $0.03，任何尺寸都一样。在 Official 渠道，按每次渲染报告的 token 付费，一次典型的 1K 或 2K 渲染约 $0.10304。价格部分按实时费率列出了每个尺寸的价格。
Gemini 3 Pro Image 免费吗？+
Google 的价格页面没有为 Gemini API 上的 Gemini 3 Pro Image 列出免费层级。在 SeedRouter 上充值一次，额度永不过期，失败的请求不扣费。
我需要修改 Gemini 请求吗？+
contents、systemInstruction、safetySettings 和 generationConfig 保持原样即可。加一个 model 字段，发送到 /v1/images/generations，再从任务中读取 Gemini 3 Pro Image 的结果。
怎么获取 Gemini 3 Pro Image 的 API Key？+
登录，充值任意金额，然后在 API Key 页面创建一把 key。同一把 key 可以调用 Gemini 3 Pro Image 和这里的所有其他模型。
Gemini 3 Pro Image 可以关闭思考吗？+
不可以。Gemini 3 Pro Image 总是先思考再出图。你可以用 includeThoughts 请求返回思考摘要，思考 token 只在 Official 渠道计费。
Gemini 3 Pro Image 和 Gemini 3.1 Flash Image 该选哪个？+
复杂指令和专业素材，用 Gemini 3 Pro Image。Gemini 3.1 Flash Image 更快，额外支持 512px 输出和极端宽高比，还能读取视频和 PDF 参考。
发送你的第一个 Gemini 3 Pro Image 请求
先在 Playground 里试用 Gemini 3 Pro Image，再把同一份 JSON 粘贴进你的代码。