跳转到主要内容
🔥 最新发布：谷歌于 2026年2月26日发布了 Nano Banana 2 (gemini-3.1-flash-image-preview)，Pro 级画质 + Flash 级速度，按量低至 $0.025/张！查看 Nano Banana 2 文档
Nano Banana Pro（代号）是谷歌图像生成模型系列，目前有以下版本可用：

​
最新版本

  • Nano Banana 2：gemini-3.1-flash-image-preview（🔥 2026年2月26日上线）— 查看详情
  • Nano Banana Pro：gemini-3-pro-image-preview（2025年11月20日上线）

​
前代版本

  • 正式版：gemini-2.5-flash-image（稳定版，支持 10 种宽高比）
  • 预览版：gemini-2.5-flash-image-preview（⚠️ 已于2025年10月30日下线）

📚 最新文档

飞书完整使用指南 - 更新最快，支持评论互动访问飞书文档获取最新的使用教程、技巧分享和问题解答。文档持续更新，遇到问题可直接在飞书上评论交流。

核心优势
  • 🔥 Nano Banana Pro 新特性：
    • 🎯 4K 高清支持：支持 1K、2K、4K 三种分辨率，最高可达 4096×4096
    • 📝 文本渲染之王：图像中的文字清晰可读，适合海报、广告等场景
    • ✨ 局部编辑：支持摄像机角度、焦点、色彩分级、场景照明调整
    • 🧠 智能推理：基于 Gemini 3 Pro，更好地理解复杂提示词
  • 🚀 通用优势：
    • ⚡ 生成速度：Nano Banana Pro 约 20 秒，前代版本约 10 秒
    • 💰 价格实惠：结合充值优惠，性价比极高
    • 🔄 完全兼容：完全兼容谷歌官方 Gemini API 格式
    • 🎨 谷歌技术：基于谷歌最新、最强的图像生成/编辑技术

​
在线调试 API

文生图 API

输入文本提示词生成图片，带交互式 Playground 在线调试。

图片编辑 API

上传图片 + 编辑指令生成新图片，带交互式 Playground 在线调试。

​
调用方式

使用谷歌原生 Gemini API 格式调用： 
POST /v1beta/models/gemini-3-pro-image-preview:generateContent
  • ✅ 支持 4K 高清分辨率（1K / 2K / 4K）
  • ✅ 10 种宽高比自由选择
  • ✅ 业界最佳文字渲染
  • ✅ 支持高级局部编辑
  • 📖 完全兼容谷歌官方 API 格式，参考 ai.google.dev/gemini-api/docs/image-generation

​
不支持的功能

以下谷歌官方功能在 API易 中不支持，需要单独计费：
  • Grounding with Google Search（谷歌搜索增强）：通过 tools: [{"google_search": {}}] 调用
  • thinkingConfig（思维模式）：仅 Nano Banana 2 支持，Nano Banana Pro 不支持
  • Image Search Grounding（图片搜索增强）：仅 Nano Banana 2 独有
其他图片生成和编辑能力均正常支持。

​
价格对比

模型定价优势
Nano Banana Pro (4K)$0.09/张（约¥0.52）🔥 4K 支持，约官方 38%
Nano Banana Pro (1K-2K)$0.09/张（约¥0.52）🔥 高清出图，约官方 67%
Nano Banana$0.025/张（约¥0.15）⭐ 快速生成，官方 52%
gpt-image-1较高-
flux-kontext-pro$0.035/张持平
性价比推荐：
  • Nano Banana Pro：4K 支持，文字渲染最强，定价约官方 38-67%
  • NanoBananaEnterprise：企业 HA 通道 1.4 倍率（$0.126/张），适合高可用需求
  • Nano Banana：快速生成（约10秒），官方 52% 价格，适合常规高质量图像生成

​
兼容性说明

如果你之前使用过以下模型，可以直接替换模型名称：

​
升级到最新版本

  • 任何旧版本 → gemini-3-pro-image-preview（🔥 推荐，Nano Banana Pro）
    • 支持 4K 高清出图
    • 文本渲染能力最强
    • 局部编辑功能

​
使用稳定版本

  • gpt-4o-image → gemini-2.5-flash-image
  • sora_image → gemini-2.5-flash-image
  • 旧版 Nano Banana → gemini-2.5-flash-image
其他参数保持不变，即可无缝切换使用。

​
API 错误处理指南

Nano Banana Pro 有严格的内容安全管控，可能在多个层级拒绝不合规请求。

candidatesTokenCount

最高优先级值为 0 时，内容在审核阶段被拒绝，未生成任何候选内容。

finishReason

次要优先级值非 STOP（如 PROHIBITED_CONTENT、SAFETY）时，表示生成过程中被拒绝。

API 文本响应

拒绝说明API 返回拒绝说明文本而非图片数据时，应将这些说明展示给用户。
完整错误处理文档详细错误处理流程、代码实现示例和最佳实践，请访问：https://xinqikeji.feishu.cn/wiki/Rslqw724YiBwlokHmRLcMVKHnRf

​
FAQ

追求性价比推荐 Nano Banana 2 (gemini-3.1-flash-image-preview)：
  • Pro 级画质 + Flash 级速度
  • 按量计费低至 $0.025/张
  • 支持 14 种宽高比（比 Pro 多 4 种）
  • 独有：思维模式、图片搜索 Grounding
追求极致画质选 Nano Banana Pro (gemini-3-pro-image-preview)：
  • 最高保真度
  • 定价 $0.05/次
详情参考 Nano Banana 2 文档。
新项目推荐：Nano Banana Pro (gemini-3-pro-image-preview)✅ Pro 版优势：
  • 支持 4K 超高清分辨率
  • 业界最佳文本渲染质量
  • 高级局部编辑功能
  • 定价仅约官方 38-67%
⚡ 前代版本 (gemini-2.5-flash-image) 适合：
  • 预算敏感场景（约$0.025/张 vs $0.09/张）
  • 需要快速生成（10s vs 20s）
  • 现有项目迁移
只需将模型名称从 gpt-4o-image 或 sora_image 更改为 gemini-3-pro-image-preview（推荐 Pro）或 gemini-2.5-flash-image（前代），其他参数保持不变。
模型返回 base64 编码的图片数据，通常为 PNG 或 JPEG 格式。代码会自动检测格式并保存为对应的文件类型。
是的，Nano Banana Pro 支持图片生成和图片编辑。请查看 图片编辑 API 参考。

​
相关文档