Gemini 3.1 Flash Image — 從 512px 到 4K 的快速生圖
Gemini 3.1 Flash Image 是 Google 的通用影像模型:從 512px 草圖到 4K 成品,14 種寬高比,支援影像、影片和 PDF 參考。沿用你的 generateContent 請求體即可。每張 $0.03 起。
- 文生圖
- 影像編輯
- 512px 到 4K
- 14 種寬高比
- 最多 14 張參考圖
- 支援影片與 PDF 輸入
寫程式碼之前,先試試 Gemini 3.1 Flash Image
用你的程式碼將要傳送的同一份 JSON 執行 Gemini 3.1 Flash Image。該介面支援的每個 generateContent 欄位都在這裡。
gemini-3.1-flash-image-official$45.00 / 1M image output tokens
描述你想要的影像,有參考圖就一併加上,提交一次即可。任務完成後結果就會顯示。
要生成或修改什麼。主體、場景、光線和風格。
需要模型讀取的影像、影片或 PDF。檔案會先上傳,再以 URL 形式傳送。
最多 14 張,以 fileData URL 傳送。
預設跟隨第一張參考圖,沒有參考圖時為 1:1。
輸出解析度,預設 1K。
只回傳影像,或影像加一段簡短文字回覆。
給模型的固定規則,例如統一的品牌風格。
該類別的攔截閾值。
灰色選項會放寬內容過濾,只能透過 API 使用,Playground 中不可選。
該類別的攔截閾值。
灰色選項會放寬內容過濾,只能透過 API 使用,Playground 中不可選。
該類別的攔截閾值。
灰色選項會放寬內容過濾,只能透過 API 使用,Playground 中不可選。
該類別的攔截閾值。
灰色選項會放寬內容過濾,只能透過 API 使用,Playground 中不可選。
0–2。留空則使用模型預設值。
0–1。留空則使用模型預設值。
整數,不小於 1。
整數。重複使用同一個值,可以更接近地復現結果。
限制文字與思考輸出的上限。
每行一個,最多 5 個。
只能為 1:一次請求回傳一張影像。
每張參考圖消耗多少 token。越低越便宜。
隨影像一起回傳模型的思考摘要。
IMAGE_JPEG 是文件中唯一列出的取值。
僅在上方的寬高比為「預設」時生效;兩者都設定時以寬高比為準。
僅在上方的影像尺寸為「預設」時生效;兩者都設定時以影像尺寸為準。
按目前費率預估:所選尺寸的影像 token,加上一份實測的文字與思考 token 樣本。在 Official 通道上,參考圖輸入會讓費用略有增加。

試試下面這幾條提示詞



透過本 API 使用 Gemini 3.1 Flash Image 生成的範例圖
Gemini 3.1 Flash Image API 價格
Gemini 3.1 Flash Image 有兩種計費方式。Standard 按張計費,任何尺寸同一個價;Official 按每次渲染回報的 token 計費,所以小圖更便宜,4K 更貴。
- Official
- $0.05132/張
- Standard
- $0.03/張
- Official
- 389張
- Standard
- 666張
兩種價格都來自對你帳戶實際計費的費率。失敗的請求不扣費。
Official 的預估使用 Google 公佈的各尺寸影像 token 數,再加上一份實測樣本:405 個文字與思考 token,以及 27 個提示詞 token。
Gemini 3.1 Flash Image 各尺寸價格
Google 公佈了 Gemini 3.1 Flash Image 各尺寸的影像 token 數,從 512px 的 747 到 4K 的 2,520。下面的 Official 價格另加了一份實測的文字與思考樣本。
| 影像尺寸 | 影像 token | 價格 · Official | 價格 · Standard |
|---|---|---|---|
| 512 | 747 | $0.03454 | $0.03 |
| 1K | 1,120 | $0.05132 | $0.03 |
| 2K | 1,680 | $0.07652 | $0.03 |
| 4K | 2,520 | $0.11432 | $0.03 |
Standard 每張圖一個固定價,所有尺寸都一樣。Official 跟隨影像 token,尺寸越大越貴。
估算你自己的 Gemini 3.1 Flash Image 請求價格
選一個尺寸,看數字怎麼變。它由即時費率和 Google 公佈的各尺寸影像 token 數算出,價格一變它也跟著變。
這是提交前的預估。Standard 按交付的每張圖計費;Official 對影像輸出、文字與思考輸出、輸入分別按各自費率計費。
| 項目 | 計量方式 | 費率 | 計費 |
|---|---|---|---|
| Official · 影像輸出 | 本次渲染報告的影像 token | $45.00 / 1M$60.00 / 1M | 按實際用量扣費 |
| Official · 文字與思考輸出 | 本次渲染報告的文字與思考 token | $2.25 / 1M$3.00 / 1M | 按實際用量扣費 |
| Official · 輸入 | 提示詞與參考圖 token | $0.375 / 1M$0.50 / 1M | 按實際用量扣費 |
| Standard · 按張計費 | 每交付一張圖,任何尺寸 | $0.03 /張$0.04 /張 | 影像交付時扣費 |
| 失敗的請求 | 任何以失敗結束的任務 | 免費 | 不扣任何費用 |
Gemini 3.1 Flash Image 是什麼?
Gemini 3.1 Flash Image 是 Google 的影像生成與編輯模型,產品名為 Nano Banana 2。Google 稱它是自家最全能的影像模型,在速度與 4K 輸出、世界知識和可靠的文字渲染之間取得平衡。
在 SeedRouter 上,你用 Google 自己的 generateContent 請求體加一個 model 欄位來呼叫 Gemini 3.1 Flash Image。提交一次,儲存任務 ID,任務完成後讀取託管的影像 URL。
模型 ID:gemini-3.1-flash-image · 按 token 計費 ID:gemini-3.1-flash-image-official · 輸入上限:131,072 token。
使用 Gemini 3.1 Flash Image 的兩種方式
從你的後端呼叫 API,或者把活交給程式設計 Agent。
呼叫 API
從你的伺服器傳送 Gemini 3.1 Flash Image 請求,儲存任務 ID,再從任務中讀取成品圖。
- 1建立 API key
- 2POST 請求體
- 3輪詢任務直到完成
交給 Agent 來做
把現成的提示詞複製到 Claude Code、Codex 或 Cursor。它會在花錢前先徵求你同意,並自動下載結果。
- 1複製提示詞
- 2填上你想要的內容
- 3批准這次請求
開發者為什麼選 Gemini 3.1 Flash Image
預設的 Gemini 影像模型:出圖快、靈活,打草稿成本低。
Google 的請求體
Gemini 3.1 Flash Image 接受的 contents 和 generationConfig,與你發給 Google 的完全一樣。加一個 model 欄位就行了。
四種輸出尺寸
用同一個 Gemini 3.1 Flash Image 請求,以 512px 起草,以 4K 定稿。
極端寬高比
Gemini 3.1 Flash Image 新增 1:4、4:1、1:8 和 8:1,適合橫幅和豎長畫幅。
影片與 PDF 參考
交給 Gemini 3.1 Flash Image 的不只是照片,也可以是一段影片或一份產品規格單。
14 張參考圖
在一次 Gemini 3.1 Flash Image 請求中組合最多 14 張參考,以 fileData URL 傳入。
基於任務
Gemini 3.1 Flash Image 渲染絕不會一直佔著你的連線。你輪詢任務,拿到 URL。
團隊都用 Gemini 3.1 Flash Image 做什麼
商品目錄圖
Gemini 3.1 Flash Image 能批次整理、美化商品照片。
社群畫幅
一條提示詞,生成方形、豎版和寬幅的 Gemini 3.1 Flash Image 多個版本。
橫幅
Gemini 3.1 Flash Image 能直接填滿 8:1 和 1:8 版式,無需裁切。
低成本草圖
用 Gemini 3.1 Flash Image 以 512px 迭代,再把定稿的那張渲染成 4K。
從文件生成
用 Gemini 3.1 Flash Image 把一份 PDF 需求簡報變成視覺圖。
編輯
用 Gemini 3.1 Flash Image 更換背景、顏色或某個物體,其餘保持不變。
四步上手 Gemini 3.1 Flash Image
- 01
建立一把 key
登入,儲值任意金額,然後建立一把 API Key。額度永不過期。
- 02
傳送一次請求
把帶有提示詞和參考圖 URL 的 Gemini 3.1 Flash Image 請求體 POST 到 /v1/images/generations。
- 03
輪詢任務
儲存任務 ID,每隔幾秒查詢一次,直到狀態變為 completed。
- 04
下載影像
把任務輸出裡的託管影像 URL 儲存到你自己的儲存。
Gemini 3.1 Flash Image 一覽
判斷 Gemini 3.1 Flash Image 是否適合你的任務,看這幾項就夠了。
| 特性 | Gemini 3.1 Flash Image |
|---|---|
| 模型 ID | gemini-3.1-flash-image |
| 輸出尺寸 | 512、1K、2K、4K |
| 寬高比 | 14 種(1:8 到 8:1) |
| 參考圖 | 最多 14 張 |
| 參考類型 | 影像、影片、PDF |
| 計費 | 按張計費(Standard)或按 token 計費(Official) |
最複雜的視覺任務請看 Gemini 3 Pro Image;想要最低成本的 1K 出圖,請看 Gemini 3.1 Flash Lite Image。
遷移 Gemini 3.1 Flash Image 程式碼之前
preview ID 仍然可用
Google 已於 2026 年 6 月 25 日下線 gemini-3.1-flash-image-preview。在這裡它仍能執行,由 gemini-3.1-flash-image 提供服務。
用 URL,不用 inlineData
Gemini 3.1 Flash Image 的參考圖請以 fileData URL 傳送。Base64 的 inlineData 會在扣費之前被拒絕。
暫不支援 Search grounding
帶 tools 的 Gemini 3.1 Flash Image 請求目前會被拒絕。
每次請求一張圖
candidateCount 為 1。需要多張時,傳送多個 Gemini 3.1 Flash Image 請求。
為什麼在 SeedRouter 上用 Gemini 3.1 Flash Image
兩種付費方式
選 Standard,每張 Gemini 3.1 Flash Image 圖一個固定價;選 Official,按每次渲染回報的 token 付費。同一把 key,同一個請求體。
失敗的請求不收費
任務以失敗結束時不扣任何費用。你只為成功交付的影像付費。
額度永不過期
儲值一次,隨時使用餘額。無需訂閱。
託管結果
成品圖以我們 CDN 上的 URL 回傳。需要長期儲存的內容,請自行備份一份。
一把 key 呼叫所有模型
同一把 key 和餘額也可用於目錄中的其他影像模型。
SeedRouter 上的其他影像模型
同一把 key、同一份餘額、同一套任務 API。
在 SeedRouter 上用 GPT Image 2 生成和編輯影像。支援文字提示詞、參考圖與透明背景,配有線上 Playground,按用量計費。
檢視價格在 SeedRouter 上用 GPT Image 2.5 Flare 或 Sunburst 生成與編輯影像。六檔品質最高到 max,支援透明背景,附線上 Playground,用多少付多少。
檢視價格用 Google 的 generateContent 請求體呼叫 Gemini 3 Pro Image(gemini-3-pro-image):1K 到 4K、內建思考、14 張參考圖,按次或按 token 計費。
檢視價格用 generateContent 請求體呼叫 Gemini 3.1 Flash Lite Image(gemini-3.1-flash-lite-image),Google 最快、最便宜的影像模型,1K 輸出。
檢視價格Gemini 3.1 Flash Image 使用教學
關於如何選型、計價和接入這個模型的實用指南。
Nano Banana 免費嗎?不付費時 Gemini 應用和 Gemini API 對 Nano Banana 2 與 Nano Banana Pro 分別提供什麼,以及從什麼時候開始收費。
一步步呼叫 Nano Banana 2 API:建立 API Key、傳送 generateContent 請求、輪詢任務、新增參考圖,以及交給程式設計 Agent 執行。
從輸出尺寸、寬高比、參考圖、思考能力和計費方式比較 Nano Banana 2、Nano Banana Pro 與 Nano Banana 2 Lite,按任務選對模型。
Nano Banana 2、Pro 和 2 Lite 的 API 目前價格:按張固定價與按 token 計費,不同解析度的單圖成本,以及各計費方式適合的場景。
Gemini 3.1 Flash Image 常見問題
Gemini 3.1 Flash Image 和 Nano Banana 2 是同一個模型嗎?+
是的。Nano Banana 2 是 Google 給 Gemini 3.1 Flash Image 起的產品名,模型 ID 為 gemini-3.1-flash-image。Nano Banana 2 頁面從產品角度介紹的是同一個模型。
有 Gemini 3 Flash Image 嗎?+
沒有。Gemini 3 系列中的 Flash 影像模型就是 Gemini 3.1 Flash Image,模型 ID 為 gemini-3.1-flash-image。搜尋 Gemini 3 Flash Image 的人,通常找的就是這個模型。
gemini-3.1-flash-image-preview 還能用嗎?+
Google 已於 2026 年 6 月 25 日關停該 preview ID。在 SeedRouter 上 gemini-3.1-flash-image-preview 仍被接受,並執行在 gemini-3.1-flash-image 上,所以你在切換 ID 期間舊程式碼照樣能跑。
Gemini 3.1 Flash Image 多少錢一張?+
在 Standard 通道,一張 1K 圖 $0.03,與提示詞無關。在 Official 通道,按每次渲染回報的 token 付費,一次典型的 1K 渲染約 $0.05132。價格部分按即時費率列出了每個尺寸的價格。
Gemini 3.1 Flash Image 免費嗎?+
Google 的價格頁面沒有為 Gemini API 上的 Gemini 3.1 Flash Image 列出免費層級。在 SeedRouter 上儲值一次,額度永不過期,失敗的請求不扣費。
我需要修改 Gemini 請求嗎?+
contents、systemInstruction、safetySettings 和 generationConfig 保持原樣即可。加一個 model 欄位,傳送到 /v1/images/generations,再從任務中讀取 Gemini 3.1 Flash Image 的結果。
怎麼取得 Gemini 3.1 Flash Image 的 API Key?+
登入,儲值任意金額,然後在 API Key 頁面建立一把 key。同一把 key 可以呼叫 Gemini 3.1 Flash Image 和這裡的所有其他模型。
Gemini 3.1 Flash Image 和 Gemini 3 Pro Image 該選哪個?+
追求速度、512px 草圖、極端寬高比以及影片或 PDF 參考,先從 Gemini 3.1 Flash Image 開始。遇到複雜指令和專業素材,再換用 Gemini 3 Pro Image。
傳送你的第一個 Gemini 3.1 Flash Image 請求
先在 Playground 裡試用 Gemini 3.1 Flash Image,再把同一份 JSON 貼進你的程式碼。
