Nano Banana 2.5 API：状态、模型 ID 与当前定价

什么是 Nano Banana 2.5？

这一说法目前混合了三个不应混淆的层面：

1. 一个产品标签。 Flow 及其他第一方界面在推广跟踪期间曾显示“Nano Banana 2.5 Flash”或相关名称。
2. 一个已确认的 API 模型。 Google 的公开 API 文档将原始 Nano Banana 图像模型标识为 gemini-2.5-flash-image。
3. 内部或合作伙伴标识符。 社区报告曾提到诸如 nano-banana-2.5 和内部图像生成器字符串之类的名称，但除非 Google 将其记录在案，否则这些并非官方公开的请求 ID。

这就是为什么搜索“Nano Banana 2.5 API”可以找到真实的实现线索，却无法得到一个名为 nano-banana-2.5 的稳定端点。最准确的说法是：在有路由可用的地方，2.5 时代的能力仍可通过已确认的 Gemini 模型访问，而品牌别名本身仍未得到确认。

Gemini 2.5 Flash Image 还能用吗？

是的，在有实时路由接受它的地方。APIMaster 在验证日期有一个 status=1 的路由，因此告诉开发者该模型已无法使用是不准确的。与此同时，Google 已将 Gemini 2.5 Flash Image 标记为弃用，并将 2027 年 3 月 15 日列为 Vertex 退役日期。弃用意味着你应规划迁移；它并不会抹除今天仍然活跃的路由。

对于新的生产工作，请优先选择 Nano Banana 2 / gemini-3.1-flash-image，除非你对 2.5 时代的行为有兼容性要求。对于现有项目，请固定 gemini-2.5-flash-image，监控错误和延迟，并在退役日期前测试迁移目标。

Nano Banana 2.5 vs Nano Banana 2

已确认的对比是在 API ID 之间，而非在两个别名之间：

• 2.5 时代 API： gemini-2.5-flash-image，在 10 月 6 日的检查中有一个活跃的 APIMaster 路由，并有 Google 的弃用通知。
• Nano Banana 2： gemini-3.1-flash-image，在同一次检查中有三个活跃的 APIMaster 路由，且是 Google 当前公开的 Nano Banana 2 映射。
• nano-banana-2.5： 本文不主张其存在单独的官方 Google API 页面或公开的 APIMaster 路由。

正确的选择取决于你是在保持兼容性还是从零开始。2.5 路由在其仍然活跃时是一个实用的过渡方案；对于新的集成，3.1 路由是更好的默认选择，因为其公开命名和生命周期定位更为清晰。

当前 APIMaster 定价

实时价格是路由观测值，而非永久的标价。Gemini 2.5 Flash Image 卡片显示了当前路由，在本文所用的检查中每 1K 图像 $0.03744 起。Nano Banana 2 卡片在三个活跃路由中每 1K 图像 $0.0469 起。两个价格均低于所引用的官方参考价格，但路由列表和折扣可能会变化。

APIMaster 的一键设置让你无需更换提供商即可测试两个已确认的 ID。这对迁移很有用：将相同的提示词和参考图像发送到两个路由，比较可用输出和延迟，然后根据工作负载而非营销标签进行选择。

如何调用 2.5 时代路由

创建一个 APIMaster 账户，在控制台中创建一个密钥，并使用已确认的 API ID 而非未经验证的别名：

curl "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image",
    "prompt": "A warm editorial product photograph of a glass teapot beside a lemon tree.",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

如果你要开始一个新项目，只需将模型值改为 gemini-3.1-flash-image，并先核实其实时卡片。端点和 APIMaster 密钥保持不变。

迁移清单

1. 将标签与 ID 分开。 将 nano-banana-2.5 存储为可选的显示标签，切勿作为假定的请求值。
2. 固定已确认的模型。 为兼容性使用 gemini-2.5-flash-image，或将 gemini-3.1-flash-image 作为新的默认选择。
3. 立即测试替代方案。 在代表性提示词上比较图像质量、编辑行为、分辨率、延迟和成本。
4. 监控生命周期日期。 将 Google 的弃用信息和 2027 年 3 月 15 日的 Vertex 退役日期保留在你的迁移日历中。
5. 检查实时路由。 APIMaster 的价格和可用性可能会变化，因此请在生产部署前重新打开模型卡片。

FAQ

Nano Banana 2.5 是官方 API 模型吗？

在本文所检查的官方文档中，Google 尚未将 nano-banana-2.5 发布为单独的公开 Gemini API 模型 ID。已确认的 2.5 时代 API ID 是 gemini-2.5-flash-image。

我还能使用 Gemini 2.5 Flash Image 吗？

可以，在有实时路由接受它的地方。APIMaster 在 2026 年 10 月 6 日有一个活跃路由。Google 已弃用该模型，并将 2027 年 3 月 15 日列为 Vertex 退役日期，因此新项目应规划迁移，而非将其视为长期默认选择。

当前的 Nano Banana 替代方案是什么？

Nano Banana 2 映射为 gemini-3.1-flash-image。在 10 月 6 日的检查中，它在 APIMaster 上有三个活跃路由，每 1K 图像 $0.0469 起。请查看实时模型卡片了解当前价格。

APIMaster 上最便宜的 2.5 时代路由是什么？

在 2026 年 10 月 6 日，gemini-2.5-flash-image 卡片在一个活跃路由中每 1K 图像 $0.03744 起，而参考价格为 $0.039。路由可能会变化，因此请以卡片为准，而非将其视为保证报价。

Nano Banana 2.5 与 Nano Banana 2.1 相同吗？

现有线索表明可能存在命名演变，但 Google 尚未正式记录这一关系。本文将两个搜索词分开处理，并在讨论实际调用时使用已确认的 API ID。

我应该在 nano-banana-2.5 上构建吗？

不。如果你需要已确认的 2.5 时代路由，请在 gemini-2.5-flash-image 上构建，或使用 gemini-3.1-flash-image 进行新集成。将任何产品标签保留在元数据中，而非请求体中。

来源与验证日期

• Google Gemini API 模型文档 — 已确认的公开模型 ID。
• Google 图像生成指南 — 图像 API 工作流。
• Google Gemini API 定价 — 官方图像生成参考定价。
• Google Cloud Gemini 2.5 Flash Image 生命周期页面 — 弃用和退役信息。
• APIMaster 实时定价目录和市场卡片，检查于 2026 年 10 月 6 日。路由可用性和价格可能在发布后发生变化。

在迁移期间使用实时图像 API

Nano Banana 2.5 仍然是一个有用的搜索词，已确认的 2.5 时代路由在可用的地方仍可使用，但该别名并非稳定的 API 契约。对于新的集成，请从 Nano Banana 2 / gemini-3.1-flash-image 开始，在所检查的 APIMaster 路由上每 1K 图像 $0.0469 起。 注册 APIMaster，在控制台中创建密钥，将你的客户端指向 https://apimaster.ai/v1，并在承诺长期迁移前比较两个实时模型卡片。