Nano Banana 系列

Google 的 Gemini 圖像模型，共五款。建議透過 Gemini 原生介面呼叫，可精確控制比例與解析度；OpenAI 相容介面同樣可用，但僅支援部分參數。

常見任務

指定比例與解析度橫圖、直圖、4K 大圖，各模型支援的取值。改圖與多圖融合上傳圖片，依文字指令編輯。錯誤排查 400 invalid argument、比例不對、沒有回傳圖片、410。

模型選擇

重點一般情境建議使用 Nano Banana 2；需要 4K 輸出或複雜構圖時選用 Pro；批次生成小尺寸圖片時選用 2 Lite。

Nano Banana 2.1最新

1K、2K、4K 三檔
支援 1:8 至 8:1 的比例；2K、4K 實測約 2 分鐘

gemini-nano-banana-2.1

Nano Banana 2日常首選

512 至 4K 四檔解析度
支援的比例最多，含 1:8、8:1

gemini-3.1-flash-image

Nano Banana Pro品質優先

1K、2K、4K 三檔
生成前會先進行推理，耗時較長

gemini-3-pro-image

Nano Banana 2 Lite速度優先

僅支援 1K
實測單張約 5 秒，輸出 JPEG

gemini-3.1-flash-lite-image

Nano Banana上一代

固定約 1K，不支援指定解析度
既有專案可繼續使用

gemini-2.5-flash-image

模型 ID（呼叫時原樣複製）

Nano Banana 2.1google/gemini-nano-banana-2.1最新

Nano Banana 2google/gemini-3.1-flash-image日常首選

Nano Banana Progoogle/gemini-3-pro-image4K、複雜構圖

Nano Banana 2 Litegoogle/gemini-3.1-flash-lite-image僅支援 1K

Nano Bananagoogle/gemini-2.5-flash-image上一代

即時價格請參閱模型頁：Nano Banana 2 、Nano Banana Pro 。實際扣費以回應中的 usageMetadata 為準。

介面選擇

重點需要控制比例與解析度時，請使用 Gemini 原生介面。

	Gemini 原生介面（建議）	OpenAI 相容介面
網址	`POST /gemini/v1beta/models/<模型 ID>:generateContent`	`POST /v1/images/generations`、`/v1/images/edits`
比例	`imageConfig.aspectRatio`	頂層 `aspect_ratio`
解析度	`imageConfig.imageSize`：512、1K、2K、4K	不支援，傳入 `image_size` 會回傳 400
`size: "寬x高"`	不適用	不支援，請用 `aspect_ratio` 指定比例
`n` 多張	不適用	不支援，每次請求生成一張
改圖	在 `parts` 中放入 `inlineData`	以 `/v1/images/edits` 上傳檔案
參考圖 `input_images`	不適用	不支援，改圖請用 `/v1/images/edits`
回傳	`candidates[0].content.parts[].inlineData.data`	`data[0].b64_json`

耗時與逾時

重點用戶端逾時請設為 300 秒以上。

介面為同步呼叫。實測 1K 約 5 至 20 秒，4K 約 30 秒；Nano Banana 2.1 的 2K、4K 約 2 分鐘。尖峰時段耗時會更長。Pro 在生成圖片前會先進行推理（回應中含 thoughtsTokenCount），耗時高於同解析度的 Nano Banana 2。常見的 60 秒預設逾時無法涵蓋 4K 及尖峰時段的請求；用戶端中斷連線後，請求仍會計費。

回應結構

200 OK（原生介面，data 已截斷）


{
  "candidates": [{
    "content": {
      "parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
      "role": "model"
    },
    "finishReason": "STOP"
  }],
  "modelVersion": "google/gemini-3-pro-image",
  "usageMetadata": {
    "promptTokenCount": 7,
    "candidatesTokenCount": 2000,
    "candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
    "thoughtsTokenCount": 211,
    "totalTokenCount": 2218
  }
}

圖片位於 parts 中含 inlineData 的項目，不一定是第一項，前面可能有文字內容。請逐一檢查 parts 尋找。
candidatesTokensDetails 中 IMAGE 項的數量即為輸出圖片的 token 數。實測 1K 為 1,120，Pro 的 4K 為 2,000。
thoughtsTokenCount 僅出現在 Pro 的回應中，表示生成圖片前的推理 token。

官方文件

官方文件描述的是直連 Google 時的行為；透過 OfoxAI 呼叫時，以本頁實測結論為準。

常見問題

Nano Banana Pro 如何生成 4K 圖片？

使用 Gemini 原生介面，在 generationConfig.imageConfig 中傳入 imageSize: "4K"，同時用 aspectRatio 指定比例。實測 16:9 的 4K 輸出 5504x3072，約 16 MB，耗時約 33 秒。OpenAI 相容介面不支援 imageSize，傳入 image_size 會回傳 400。

Nano Banana 2 支援哪些比例？

常用 10 種：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9；另外支援 1:4、4:1、1:8、8:1 四種超寬或超長比例。不在清單中的比例會回傳 400 Request contains an invalid argument。

Nano Banana Pro 支援 1:8 或 4:1 嗎？

不支援。1:4、4:1、1:8、8:1 這四種比例只有 Nano Banana 2.1、Nano Banana 2 與 Nano Banana 2 Lite 支援，需要超長或超寬圖片請使用這三款。

imageSize 要寫 4K 還是 4k？

建議寫大寫 1K、2K、4K，與 Google 官方一致。實測 OfoxAI 也接受小寫。512 檔不帶 K，只有 Nano Banana 2 支援。

用 OpenAI 相容介面如何指定 Nano Banana 的比例？

使用頂層的 aspect_ratio，例如 "16:9"。該介面不支援解析度參數，需要 2K、4K 請使用 Gemini 原生介面的 imageConfig.imageSize。

Nano Banana 一次能生成多張圖嗎？

不能，一次請求生成一張。如需多張，請並行發出多次請求，並留意速率限制。

Nano Banana 的逾時應設定多少？

建議 300 秒以上。實測 1K 約 5 至 20 秒，4K 約 30 秒，Nano Banana 2.1 的 2K、4K 約 2 分鐘，尖峰時段耗時更長。Pro 在生成前會先進行推理，耗時高於 Nano Banana 2。