作者注：Gemini 3.1 Flash Image 与 Gemini 3 Pro Image 于 5 月 28 日转 GA，本文解析 -preview 后缀移除的时间线、Nano Banana Pro 与 2 的 5 大变化，以及 APIYI 同步上线的接入要点。
5 月 28 日，Google DeepMind 把 gemini-3.1-flash-image-preview 与 gemini-3-pro-image-preview 两个图像模型同时转为正式版（GA），分别对应 Nano Banana 2 与 Nano Banana Pro。这意味着开发者再也不需要在生产环境里写带 -preview 后缀的临时 ID，可以直接调用稳定版本。同日，gemini-3.1-flash-image 还获得了视频转图像（video-to-image）这一全新能力。
对 APIYI 用户而言，最直接的变化是：原本以 gemini-3.1-flash-image-preview 调用的接口已平滑升级为 gemini-3.1-flash-image，无需重写客户端代码，仅修改模型名即可继承所有新能力。在 GA 上线当天，APIYI 即完成了同步，开发者可通过 apiyi.com 以 OpenAI 兼容协议直接调用。
本文将系统梳理三个核心问题：-preview 后缀究竟何时被去掉、Nano Banana Pro 与 Nano Banana 2 在 GA 化过程中各自有哪些变化、以及如何在生产环境快速完成迁移。所有信息均来自 Google 官方公告与 DeepMind 模型卡片，避免坊间猜测带来的版本混淆。
什么是 Gemini 3.1 Flash Image 去 preview 的关键时间线
要理解这次 GA 转换的意义，需要先看清两个 Nano Banana 系列模型完整的发布节奏。从首次预览到稳定版本，整个过程跨越约 6 个月，符合 Google AI 一贯的「预览 → 收集反馈 → GA」三段式节奏。
| 日期 | 事件 | 模型 ID | 状态 |
|---|---|---|---|
| 2025 年 11 月 20 日 | Nano Banana Pro 首次预览 | gemini-3-pro-image-preview |
Preview |
| 2026 年 2 月 26 日 | Nano Banana 2 首次预览 | gemini-3.1-flash-image-preview |
Preview |
| 2026 年 5 月 28 日 | 两款模型同步转 GA | gemini-3-pro-image / gemini-3.1-flash-image |
GA ✅ |
| 2026 年 6 月 25 日 | 预览版正式下线 | *-preview 后缀模型 |
停服 |
从时间线可以看出几个关键信号。
第一，Pro 与 2 这次是「同窗发布、同窗毕业」。虽然两者预览时间错开 3 个月，但 Google 选择在同一天把两者同步转 GA，背后是产品矩阵层面对图像生成「双模型策略」的正式确认——一个走极致质量（Pro），一个走极致效率（Flash/2）。
第二，预览版在 GA 后还会保留约 4 周缓冲期，6 月 25 日正式下线。这给开发者留出了充足的迁移时间，但生产环境里仍然使用 *-preview 后缀的代码必须在 6 月 25 日前完成切换，否则会出现 404 类型的错误。
第三，GA 不只是「去 preview」，gemini-3.1-flash-image 还在 GA 当天新增了 video-to-image 能力，可以从视频输入生成缩略图、海报、关键帧静态图。这是预览版从未具备的功能。
🎯 迁移建议：如果你正在使用
gemini-3.1-flash-image-preview或gemini-3-pro-image-preview，我们建议在 6 月 25 日前完成模型 ID 替换。通过 API易 apiyi.com 平台调用时，已自动支持新旧两个 ID，可平滑过渡。
Nano Banana Pro 和 2 的 5 大核心变化解读
GA 不是简单换个名字。从预览到稳定，两个模型在能力、稳定性、价格策略上都做了系统性优化。下面拆解 5 大核心变化。
变化一：模型 ID 标准化，去除 -preview 后缀
最直观的变化是模型 ID 的清理。新旧 ID 对照如下：
| 模型用途 | 预览版 ID（已废弃） | GA 正式版 ID |
|---|---|---|
| 高质量图像（Pro） | gemini-3-pro-image-preview |
gemini-3-pro-image |
| 高效率图像（Flash/2） | gemini-3.1-flash-image-preview |
gemini-3.1-flash-image |
去掉 -preview 后缀的实际意义不止是命名美观。它代表 Google 把这两个模型纳入了正式的 SLA 与版本管理体系：从此享受稳定的回归测试、可预期的能力变更窗口，以及生产级的可用性承诺。
变化二：gemini-3.1-flash-image 新增视频转图像能力
这是 GA 当天最有「料」的能力升级。新版的 gemini-3.1-flash-image 支持把视频作为输入，直接输出代表性静态图——典型用途包括：
- 视频自动生成封面缩略图
- 长视频关键帧抽取并合成海报
- 直播流截取代表画面用于推流封面
- 视频 + prompt 组合生成主题宣传海报
预览版仅支持文本与图像输入，无法处理视频。GA 把这块短板补齐后，gemini-3.1-flash-image 在视频平台、短视频工具、电商商品视频等场景的价值显著提升。
变化三：上下文窗口扩展至 1M tokens
DeepMind 模型卡片显示，gemini-3.1-flash-image 的输入上下文窗口可达 100 万 tokens。这个规格在图像生成模型里非常少见，意味着：
- 一次调用可以塞入大量参考图与品牌素材
- 长 prompt 与多轮编辑历史可以完整传入
- 可以承载复杂的「多源参考 + 风格指令」组合
| 规格维度 | gemini-3.1-flash-image（GA） |
|---|---|
| 输入上下文窗口 | 100 万 tokens |
| 图像输出能力 | 最高 4K tokens |
| 文本输出能力 | 最高 64K tokens |
| 输入模态 | 文本、图像、音频、视频 |
| 知识截止 | 2025 年 1 月 |
变化四：4K 分辨率正式支持，且支持 512px 起的多档输出
新版正式承诺支持 512px 到 4K 的多档分辨率，开发者可以根据场景选择合适档位以平衡成本与质量。多种宽高比也同步在 GA 中确认支持，包括常见的 1:1、4:3、3:4、16:9、9:16 等。
变化五：多主体一致性提升至 5 角色 14 物体
预览阶段 Nano Banana 2 已经在多主体一致性上有所突破，GA 阶段官方明确给出量化指标：单图最多保持 5 个角色与 14 个物体的视觉一致性。这是当前公开图像生成模型里少见的「定量承诺」，对故事插画、产品组合图、电商商品多 SKU 主图等场景是直接利好。
🎯 能力选型：如果你的业务以多主体场景图、故事插画为主，我们建议优先评估 gemini-3.1-flash-image。可通过 API易 apiyi.com 平台快速测试不同主体数量下的稳定性，平台已完整同步 GA 版本。
为什么 Gemini 3.1 Flash Image 与 Gemini 3 Pro Image 选择并存
GA 后，Google 没有让 Flash 取代 Pro，也没有让 Pro 吞并 Flash，而是明确把两者定位为「双轨并存」。这背后的产品哲学值得每个开发者理解。
性能定位：Pro 主打质量，Flash 主打效率
Pro 适合「视觉关键时刻」——含可见文字的海报、信息图、品牌物料、复杂排版的产品 mockup。Flash 适合「高吞吐场景」——内容平台的 UGC 配图、电商批量主图、社媒短文配图、Agent 工作流里的中间图。
| 维度 | gemini-3-pro-image | gemini-3.1-flash-image |
|---|---|---|
| 核心定位 | 高质量、复杂排版 | 高效率、高吞吐 |
| 文字渲染 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 复杂图表 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 速度 | 标准 | 更快 |
| 单图成本 | 基准 | 约低 33%～59%（2K/4K） |
| 多主体一致性 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐（5 角色/14 物体） |
| 视频输入 | 部分支持 | ✅ 正式支持 |
| 推荐使用场景 | 品牌物料、信息图 | 默认 API 调用 |
成本结构：Flash 显著低于 Pro
第三方评测数据显示，在 2K 输出档位 Pro 比 Flash 单图成本高出约 33%，在 4K 输出档位差距扩大到约 59%。对于以图像为主要产品形态的应用，这个差异会直接影响月度账单。
何时选 Pro，何时选 Flash？决策清单
实际选型可以用这个简化清单：
- prompt 包含可见文字 → 优先 Pro（文字渲染更稳）
- 需要精确品牌色与排版 → 优先 Pro
- 高并发 API 调用 → 优先 Flash
- 批量生成 UGC 配图 → 优先 Flash
- 多主体复杂场景 → 优先 Flash（5 角色 14 物体硬指标）
- 视频缩略图/封面 → 必须 Flash（Pro 无此能力）
- 不确定场景 → 默认 Flash，质量不够再升 Pro
🎯 混合策略：很多生产应用采用「Flash 打草稿，Pro 出终稿」的两阶段流程。我们推荐通过 API易 apiyi.com 平台同时调用两款模型，平台 OpenAI 兼容协议让两个模型的切换只需替换
model字段。
如何在 APIYI 调用 Gemini 3.1 Flash Image GA 版
APIYI 已于 5 月 28 日同步上线 GA 版本，开发者可通过两种方式调用：原生 Gemini 协议或 OpenAI 兼容协议。后者更适合从 OpenAI 生态迁移的项目。
极简调用示例（OpenAI 兼容协议）
from openai import OpenAI
client = OpenAI(
api_key="你的 APIYI Key",
base_url="https://api.apiyi.com/v1"
)
response = client.chat.completions.create(
model="gemini-3.1-flash-image", # GA 正式版，无 -preview 后缀
messages=[
{"role": "user", "content": "生成一张电商风格的运动鞋主图，白色背景，3:4 比例"}
]
)
print(response.choices[0].message.content)
切换到 Pro 版本
response = client.chat.completions.create(
model="gemini-3-pro-image", # 切到高质量 Pro 版
messages=[
{"role": "user", "content": "生成一张产品发布会主视觉海报，含品牌名 ACME 与日期 2026.06.10"}
]
)
仅需修改 model 字段，其余调用代码完全一致。
视频输入示例（Flash 独有能力）
# 利用 gemini-3.1-flash-image 的 video-to-image 能力
response = client.chat.completions.create(
model="gemini-3.1-flash-image",
messages=[
{"role": "user", "content": [
{"type": "text", "text": "从这段视频中生成一张吸引点击的封面图"},
{"type": "video_url", "video_url": {"url": "https://example.com/video.mp4"}}
]}
]
)
整个迁移过程通常只需要替换 model 字段，原有的 OpenAI SDK 代码可以直接复用，无需重写客户端逻辑。
老 -preview 模型何时下线？迁移注意事项
虽然 GA 已经推出，但预览版并未当天关停。根据 Google 官方公告，gemini-3.1-flash-image-preview 与 gemini-3-pro-image-preview 将于2026 年 6 月 25 日正式停服。这意味着开发者还有约 4 周缓冲期完成迁移，但务必避免拖到最后。
迁移时间表
| 时间节点 | 状态 | 建议动作 |
|---|---|---|
| 5 月 28 日—6 月 10 日 | 双版本并存 | 开发环境切到 GA 测试 |
| 6 月 10 日—6 月 20 日 | 双版本并存 | 生产环境分批切换 |
| 6 月 20 日—6 月 24 日 | 缓冲尾段 | 完成所有切换，监控对比 |
| 6 月 25 日及之后 | 仅 GA 可用 | 预览版 404，必须完成迁移 |
迁移检查清单
完成切换前建议确认以下项：
- 代码中所有
gemini-3.1-flash-image-preview字符串已替换为gemini-3.1-flash-image - 代码中所有
gemini-3-pro-image-preview字符串已替换为gemini-3-pro-image - 测试覆盖关键 prompt 类型（含文字、多主体、4K 输出等）
- 监控指标对比 GA 与预览版的延迟与质量差异
- 验证视频输入相关流程在 GA Flash 上的行为
🎯 平滑迁移建议：在 APIYI 平台调用时，新旧 ID 在缓冲期内均可用，可在客户端做灰度切换。我们推荐通过 API易 apiyi.com 平台先在 10% 流量上验证 GA 版本，确认稳定后再全量切换，可降低线上风险。
Gemini 3.1 Flash Image GA 影响分析
这次 GA 转换对图像生成赛道的影响，比单次模型更新更深远。它代表 Google 完成了「双模型矩阵」的产品成型，与 OpenAI 的 GPT Image 系列、Midjourney、Stable Diffusion 形成了清晰的差异化竞争。
对开发者：选型逻辑更清晰
Preview 阶段开发者常困惑「该用 Pro 还是 2」，GA 后定位清晰：默认 Flash，文字/品牌场景升 Pro。这种「清晰的双选项」减少了试错成本。
对应用产品：可放心进生产
预览模型通常不建议进生产（SLA 不保证、API 行为可能变更）。GA 后，gemini-3.1-flash-image 与 gemini-3-pro-image 都已具备生产级 SLA，应用方可以放心把它们嵌入核心业务流程。
对竞争格局：Flash 成本压力外溢
Nano Banana 2 在 2K 与 4K 档位的成本优势会传导到下游 AI 应用，间接迫使其他图像 API 厂商调整价格策略。预计未来一个季度内，主流图像 API 价格曲线会进一步下探。
Gemini 3.1 Flash Image GA 常见问题 FAQ
gemini-3.1-flash-image 的 -preview 后缀什么时候去掉的？
2026 年 5 月 28 日。同日 gemini-3-pro-image-preview 也转为 gemini-3-pro-image。预览版本将于 2026 年 6 月 25 日正式下线。
Nano Banana Pro 和 Nano Banana 2 是同一个模型吗？
不是。Nano Banana Pro 对应 gemini-3-pro-image，主打高质量与复杂排版；Nano Banana 2 对应 gemini-3.1-flash-image，主打高效率与吞吐。两者并行存在，针对不同场景。
GA 版本与预览版本能力完全一致吗？
不完全一致。GA 版本除了去掉 -preview 后缀，还在 gemini-3.1-flash-image 上新增了视频转图像（video-to-image）能力，整体稳定性与 SLA 也有提升。详细规格可参考 APIYI 文档 help.apiyi.com。
怎么在 APIYI 上调用 GA 版本？
直接将 model 字段从 gemini-3.1-flash-image-preview 改为 gemini-3.1-flash-image 即可，其他调用参数无需调整。我们建议通过 API易 apiyi.com 平台进行调用，平台已完整同步 GA 版本。
默认应该选 Pro 还是 Flash？
Google 官方与多数评测建议把 Flash（gemini-3.1-flash-image）作为默认选项，只在 prompt 含可见文字、需要精确排版、或品牌关键输出场景下升级到 Pro。这样能在多数场景获得最佳成本效益比。
gemini-3.1-flash-image 支持哪些输入模态？
GA 版本支持文本、图像、音频、视频四种输入模态，输入上下文窗口最高可达 100 万 tokens。其中视频输入是 GA 阶段新增的能力。
如果我现在还在用预览版，会受影响吗？
短期内不会，但 6 月 25 日之后预览版会停服，到时调用会失败。建议在 6 月 20 日前完成切换，留出缓冲。可通过 API易 apiyi.com 平台监控两个版本的实际行为差异。
Flash 4K 比 2K 贵多少？是否值得升 4K？
不同分辨率档位差距不算夸张，但 4K 单图成本明显高于 2K。如果业务场景以社媒、网页配图为主，2K 通常足够；只有印刷物料、大屏展示、专业海报等场景才需要 4K。
Gemini 3.1 Flash Image GA Key Takeaways 核心要点
- GA 时间确定：2026 年 5 月 28 日，gemini-3.1-flash-image 与 gemini-3-pro-image 同步去 preview
- 预览版下线日期：2026 年 6 月 25 日，必须在此之前完成模型 ID 迁移
- Flash 新增视频输入：GA 版 gemini-3.1-flash-image 支持 video-to-image 生成
- 1M tokens 上下文：Flash 输入窗口达 100 万 tokens，支持复杂多参考图组合
- 多主体硬指标：单图最多保持 5 角色 14 物体的视觉一致性
- Pro/Flash 并存：双模型矩阵正式确立，按场景选用不再混淆
- APIYI 同日同步：5 月 28 日完成 GA 版本同步，OpenAI 兼容协议直接调用
总结
Gemini 3.1 Flash Image 与 Gemini 3 Pro Image 的同步 GA，标志着 Google 在图像生成赛道完成了从「实验性能力」到「生产级双模型矩阵」的关键升级。去 -preview 后缀只是表象，背后是稳定 SLA、新视频能力、1M tokens 上下文与定量化的多主体一致性承诺。
对开发者而言，这次升级几乎零迁移成本——替换模型 ID 即可享受全部新能力。真正需要思考的是「Pro 与 Flash 怎么分工」：默认走 Flash 追求成本与速度，关键场景升 Pro 追求质量。
🎯 最终建议：我们推荐通过 API易 apiyi.com 平台同时调用 gemini-3.1-flash-image 与 gemini-3-pro-image，享受统一接口的同时按场景灵活切换。平台已于 5 月 28 日完成 GA 同步，OpenAI 兼容协议让接入只需几分钟，且新旧 ID 在 6 月 25 日缓冲期内均可平滑过渡。
作者：APIYI 技术团队 | 更多 AI 模型实测内容，请访问 help.apiyi.com
