跳轉到主要內容
🔥 最新發布：谷歌於 2026年2月26日釋出了 Nano Banana 2 (gemini-3.1-flash-image)，Pro 級畫質 + Flash 級速度，按量低至 $0.025/張！檢視 Nano Banana 2 文件
🆕 2026年5月29日更新（去掉 -preview）：谷歌更新了官方文件，推出去掉 -preview 的正式模型名 gemini-3-pro-image，API易已同步上線支援。
  • 本文件已統一使用正式名 gemini-3-pro-image，新接入請直接用它。
  • 原模型名仍可用：gemini-3-pro-image-preview 繼續正常呼叫，價格不變，現有程式碼無需改動。
話說在前面：正式版相比 preview 版在效果表現、安全稽核機制等方面是否存在差異，谷歌官方暫未明確說明，歡迎大家在實際使用中一起測試反饋。
圖片 API 全部為同步呼叫：沒有非同步任務 ID，客戶端斷開連線結果即丟失、但請求仍會計費。請為本模型設定足夠大的 timeout，詳見 圖片 API 呼叫須知與最佳實踐。
Nano Banana Pro（代號）是谷歌影像生成模型系列，目前有以下版本可用：

​
最新版本

  • Nano Banana 2.1：gemini-nano-banana-2.1（🆕 2026年10月6日上線，Nano Banana 2 的升級版）— 檢視詳情
  • Nano Banana 2：gemini-3.1-flash-image（🔥 2026年2月26日上線）— 檢視詳情
  • Nano Banana Pro：gemini-3-pro-image（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 線上除錯。

​
讓 AI Agent 幫你接入

複製這段提示詞，貼上給 Codex / Claude Code / Cursor

它會先抓本頁的純文本版（任意文件頁地址後加 .md），再按你專案的技術棧寫程式碼——超時、parts 防禦式解析、上傳壓縮、解析度引數這幾個高頻坑已經寫死在要求裡。

幫我在當前專案裡接入 / 排查 Nano Banana Pro（gemini-3-pro-image）的「文生圖 + 圖片編輯」。

先讀文件再動手：抓 https://docs.apiyi.com/api-capabilities/nano-banana-image/overview.md 拿到本頁純文本版；需 …

  1. 超時：走 Gemini 原生格式 …

共 7 條接入要求，點下方按鈕複製完整版

​
為什麼選 API易 的 Nano Banana Pro

Nano Banana Pro / 2 是 API易 消耗量排名第一的影像模型——穩定、可靠、速度快。如果你期望跟專業的團隊合作，那選 API易 就對了。 針對 Nano Banana Pro 這種谷歌最新旗艦、內容安全管控嚴格的模型，API易 在穩定性、成本、接入體驗三方面做了深度最佳化：

官方通道 · 與 Gemini 一致

完全相容谷歌官方 Gemini API 格式（/v1beta/models/.../generateContent），同時支援 OpenAI SDK 模式，請求體、響應欄位、錯誤碼與官方一致，遷移零改造。

不限併發 · 企業可放量

無谷歌 AI Studio 的 RPM/RPD 硬限制，企業批量出圖、高峰流量都能線性放大，避免被官方配額打斷。

官網 31-38% 價格

按次 $0.09/張（官方 4K $0.24），疊加 充值加贈活動 最低可達官方 31.25%——4K 場景最多省 68.75%。

全球零門檻接入

無需海外伺服器或代理，國內機房、家寬網路、海外節點均可直連 api.apiyi.com，延遲穩定、免去出海改造。

模型生態齊全

同系列覆蓋 Nano Banana 2（價效比 + Flash 速度）、Nano Banana Pro（極致畫質）、Nano Banana 第一代（基礎版），按場景自由組合。

專業服務 · 企業陪跑

團隊深耕影像生成場景，具備豐富的選型、調優與整合經驗，可為企業客戶提供從 PoC 到生產上線的完整技術支援。

​
呼叫方式

使用谷歌原生 Gemini API 格式呼叫：
  • ✅ 支援 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 支援，文字渲染最強，定價約官方 38-67%
  • NanoBananaEnterprise：企業 HA 通道 1.4 倍率（$0.126/張），適合高可用需求
  • Nano Banana：快速生成（約10秒），官方 52% 價格，適合常規高品質影像生成

​
分組介紹

Nano Banana Pro 在 API易提供兩個分組，可在後臺「令牌設定」中切換： 1.4x 倍率怎麼來的？ 1.4x 後仍約等於谷歌官方 5 折水平，遠低於官網原價。這是面向更高併發需求、應對意外風控時的兜底方案，為企業客戶提供高可用性保障。預設分組緊張時，把令牌切到 NanoBananaEnterprise 即可臨時過渡。 令牌「計費模式」推薦：選 按量優先（Pay-as-you-go Priority）—— 同時相容 Nano Banana Pro 的按次計費 和 Nano Banana 2 的按量計費，一把令牌跑全系列。
令牌建立介面：計費模式『按量優先』相容 NB Pro 按次 + NB2 按量；主分組 Default + 兜底分組 NanoBananaEnterprise（1.4x 兜底通道）

令牌設定：計費模式選「按量優先」，主分組選 Default、兜底分組掛上 NanoBananaEnterprise（1.4x）

拓展玩法：如果你的令牌還覆蓋其它影像模型（如 GPT-image-2），把更穩的 Default 分組放主位、NanoBananaEnterprise 放兜底位即可，主分組 429 會自動回退到企業分組繼續出圖，無需切換 token。

​
相容性說明

如果你之前使用過以下模型，可以直接替換模型名稱：

​
升級到最新版本

  • 任何舊版本 → gemini-3-pro-image（🔥 推薦，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
其他引數保持不變，即可無縫切換使用。

​
支援的解析度與寬高比

​
輸出解析度

Nano Banana Pro 支援 1K、2K、4K 三檔解析度（不含 Nano Banana 2 獨有的 512px）：

​
各寬高比的輸出尺寸（畫素）

下表為 Nano Banana Pro 在 1K / 2K / 4K 三檔解析度下、10 種寬高比對應的實際輸出畫素尺寸（資料來源：谷歌官方文件）。在請求中通過 aspect_ratio 指定寬高比、image_size（或 resolution）指定解析度即可：
需要 1:4、4:1、1:8、8:1 這類超長/超寬比例，或 512px 低解析度檔位時，請使用 Nano Banana 2（支援 14 種寬高比 + 512px）。

​
API 錯誤處理指南

Nano Banana Pro 有嚴格的內容安全管控，可能在多個層級拒絕不合規請求。

candidatesTokenCount

最高優先順序值為 0 時，內容在稽核階段被拒絕，未生成任何候選內容。

finishReason

次要優先順序值非 STOP（如 PROHIBITED_CONTENT、SAFETY）時，表示生成過程中被拒絕。

API 文本響應

拒絕說明API 返回拒絕說明文本而非圖片資料時，應將這些說明展示給使用者。

​
FAQ

追求價效比推薦 Nano Banana 2 (gemini-3.1-flash-image)：
  • Pro 級畫質 + Flash 級速度
  • 按量計費低至 $0.025/張
  • 支援 14 種寬高比（比 Pro 多 4 種）
  • 獨有：思維模式、圖片搜尋 Grounding
追求極致畫質選 Nano Banana Pro (gemini-3-pro-image)：
  • 最高保真度
  • 定價 $0.09/次
詳情參考 Nano Banana 2 文件。
新專案推薦：Nano Banana Pro (gemini-3-pro-image)✅ 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（推薦 Pro）或 gemini-2.5-flash-image（前代），其他引數保持不變。
模型返回 base64 編碼的圖片資料，通常為 PNG 或 JPEG 格式。程式碼會自動檢測格式並儲存為對應的檔案型別。
是的，Nano Banana Pro 支援圖片生成和圖片編輯。請檢視 圖片編輯 API 參考。
完整報錯形如：
這種錯誤往往是上傳的圖片體積過大，請求體超限把連線壓崩了。請按以下最佳實踐處理：
  • 控制圖片張數：保持在官方規則內（每個提示最多 14 張圖），不要堆圖。
  • 控制單圖體積：每張圖儘量不要超過 5MB——官方單圖上限為 7MB，且 base64 編碼後體積還會膨脹約 1/3，原圖請留足餘量。
  • 前端先壓縮再上傳：在前端（或服務端中轉層）壓縮後再提交給介面，常見做法是限制最長邊、轉 JPEG/WebP 並控制品質引數。
  • 改用 URL 傳圖：Gemini 原生格式支援 fileData.fileUri 直接傳圖片 URL，可避開 base64 請求體過大的問題，詳見 Nano Banana 開發指南。

​
相關文件