Gemini 3 Pro Image — Google 的高階影像模型,一次 API 呼叫即可用
Gemini 3 Pro Image 是 Google 面向專業影像工作的模型:1K 到 4K 輸出,內建思考,最多 14 張參考圖。直接傳送你熟悉的 generateContent 請求體。每張 $0.03 起。
- 文生圖
- 影像編輯
- 1K 到 4K
- 內建思考
- 最多 14 張參考圖
- generateContent 請求體
寫程式碼之前,先試試 Gemini 3 Pro Image
用你的程式碼將要傳送的同一份 JSON 執行 Gemini 3 Pro Image。該介面支援的每個 generateContent 欄位都在這裡。
gemini-3-pro-image-official$90.00 / 1M image output tokens
描述你想要的影像,有參考圖就一併加上,提交一次即可。任務完成後結果就會顯示。
要生成或修改什麼。主體、場景、光線和風格。
模型需要參照的參考圖。檔案會先上傳,再以 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 Pro Image 生成的範例圖
Gemini 3 Pro Image API 價格
Gemini 3 Pro Image 有兩種計費方式。Standard 按張計費,任何尺寸同一個價;Official 按每次渲染回報的 token 計費,其中 1K 和 2K 價格相同,4K 更貴。
- Official
- $0.10304/張
- Standard
- $0.03/張
- Official
- 194張
- Standard
- 666張
兩種價格都來自對你帳戶實際計費的費率。失敗的請求不扣費。
Official 的預估使用 Google 公佈的各尺寸影像 token 數,再加上一份實測樣本:246 個文字與思考 token,以及 14 個提示詞 token。
Gemini 3 Pro Image 各尺寸價格
Google 公佈了 Gemini 3 Pro Image 各尺寸的影像 token 數:1K 和 2K 為 1,120,4K 為 2,000。下面的 Official 價格另加了一份實測的思考樣本。
| 影像尺寸 | 影像 token | 價格 · Official | 價格 · Standard |
|---|---|---|---|
| 1K | 1,120 | $0.10304 | $0.03 |
| 2K | 1,120 | $0.10304 | $0.03 |
| 4K | 2,000 | $0.18224 | $0.03 |
Standard 每張圖一個固定價,所有尺寸都一樣。Official 跟隨影像 token,尺寸越大越貴。
估算你自己的 Gemini 3 Pro Image 請求價格
選一個尺寸,看數字怎麼變。它由即時費率和 Google 公佈的各尺寸影像 token 數算出,價格一變它也跟著變。
這是提交前的預估。Standard 按交付的每張圖計費;Official 對影像輸出、文字與思考輸出、輸入分別按各自費率計費。
| 項目 | 計量方式 | 費率 | 計費 |
|---|---|---|---|
| Official · 影像輸出 | 本次渲染報告的影像 token | $90.00 / 1M$120.00 / 1M | 按實際用量扣費 |
| Official · 文字與思考輸出 | 本次渲染報告的文字與思考 token | $9.00 / 1M$12.00 / 1M | 按實際用量扣費 |
| Official · 輸入 | 提示詞與參考圖 token | $1.50 / 1M$2.00 / 1M | 按實際用量扣費 |
| Standard · 按張計費 | 每交付一張圖,任何尺寸 | $0.03 /張$0.04 /張 | 影像交付時扣費 |
| 失敗的請求 | 任何以失敗結束的任務 | 免費 | 不扣任何費用 |
Gemini 3 Pro Image 是什麼?
Gemini 3 Pro Image 是 Google 的影像生成與編輯模型,產品名為 Nano Banana Pro。Google 稱它是應對最複雜視覺任務的高階之選,專為專業素材製作而設計。
在 SeedRouter 上,你用 Google 自己的 generateContent 請求體加一個 model 欄位來呼叫 Gemini 3 Pro Image。提交一次,儲存任務 ID,任務完成後讀取託管的影像 URL。
模型 ID:gemini-3-pro-image · 按 token 計費 ID:gemini-3-pro-image-official · 輸入上限:65,536 token。
使用 Gemini 3 Pro Image 的兩種方式
從你的後端呼叫 API,或者把活交給程式設計 Agent。
呼叫 API
從你的伺服器傳送 Gemini 3 Pro Image 請求,儲存任務 ID,再從任務中讀取成品圖。
- 1建立 API key
- 2POST 請求體
- 3輪詢任務直到完成
交給 Agent 來做
把現成的提示詞複製到 Claude Code、Codex 或 Cursor。它會在花錢前先徵求你同意,並自動下載結果。
- 1複製提示詞
- 2填上你想要的內容
- 3批准這次請求
開發者為什麼選 Gemini 3 Pro Image
當一次渲染必須把複雜指令做對時,就用這個 Gemini 模型。
Google 的請求體
Gemini 3 Pro Image 接受的 contents 和 generationConfig,與你發給 Google 的完全一樣。加一個 model 欄位就行了。
先思考,再動筆
Gemini 3 Pro Image 會先推理佈局。想知道原因時,用 includeThoughts 請求回傳思考摘要。
文字清晰可讀
Google 把資訊圖、選單和圖表中清晰、有設計感的文字列為其 Gemini 3 影像模型的強項之一。
4K 輸出
Gemini 3 Pro Image 可渲染 1K、2K 和 4K。按 token 計費時,2K 與 1K 價格相同。
14 張參考圖
在一次 Gemini 3 Pro Image 請求中組合最多 14 張參考圖,以 fileData URL 傳入。
基於任務
耗時較長的 Gemini 3 Pro Image 渲染絕不會一直佔著你的連線。你輪詢任務,拿到 URL。
團隊都用 Gemini 3 Pro Image 做什麼
資訊圖與圖表
Gemini 3 Pro Image 能把筆記變成帶標註的講解圖。
品牌一致的整套素材
Google 把準確的品牌一致性列為 Gemini 3 Pro Image 的強項之一,很適合製作整套行銷素材。
印刷作品
用 Gemini 3 Pro Image 生成 4K 海報和包裝。
本地化素材
Google 強調了先進的本地化能力,因此一張 Gemini 3 Pro Image 設計可以承載多種語言的文字。
商品場景
把參考照片中的商品放進 Gemini 3 Pro Image 生成的新場景。
精準編輯
用 Gemini 3 Pro Image 只改影像中的一個元素,其餘保持不變。
四步上手 Gemini 3 Pro Image
- 01
建立一把 key
登入,儲值任意金額,然後建立一把 API Key。額度永不過期。
- 02
傳送一次請求
把帶有提示詞和參考圖 URL 的 Gemini 3 Pro Image 請求體 POST 到 /v1/images/generations。
- 03
輪詢任務
儲存任務 ID,每隔幾秒查詢一次,直到狀態變為 completed。
- 04
下載影像
把任務輸出裡的託管影像 URL 儲存到你自己的儲存。
Gemini 3 Pro Image 一覽
判斷 Gemini 3 Pro Image 是否適合你的任務,看這幾項就夠了。
| 特性 | Gemini 3 Pro Image |
|---|---|
| 模型 ID | gemini-3-pro-image |
| 輸出尺寸 | 1K、2K、4K |
| 寬高比 | 10 種(9:16 到 21:9) |
| 參考圖 | 最多 14 張圖 |
| 思考 | 始終開啟;可選回傳思考摘要 |
| 計費 | 按張計費(Standard)或按 token 計費(Official) |
需要 512px 草圖、極端寬高比或影片輸入?請看 Gemini 3.1 Flash Image。
遷移 Gemini 3 Pro Image 程式碼之前
preview ID 仍然可用
Google 已於 2026 年 6 月 25 日下線 gemini-3-pro-image-preview。在這裡它仍能執行,由 gemini-3-pro-image 提供服務。
用 URL,不用 inlineData
Gemini 3 Pro Image 的參考圖請以 fileData URL 傳送。Base64 的 inlineData 會在扣費之前被拒絕。
暫不支援 Search grounding
帶 tools 的 Gemini 3 Pro Image 請求目前會被拒絕。
每次請求一張圖
candidateCount 為 1。需要多張時,傳送多個 Gemini 3 Pro Image 請求。
為什麼在 SeedRouter 上用 Gemini 3 Pro Image
兩種付費方式
選 Standard,每張 Gemini 3 Pro 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.1 Flash Image(gemini-3.1-flash-image):512px 到 4K、14 種寬高比、14 張參考圖,按張計費。
檢視價格用 generateContent 請求體呼叫 Gemini 3.1 Flash Lite Image(gemini-3.1-flash-lite-image),Google 最快、最便宜的影像模型,1K 輸出。
檢視價格Gemini 3 Pro 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 Pro Image 常見問題
Gemini 3 Pro Image 和 Nano Banana Pro 是同一個模型嗎?+
是的。Nano Banana Pro 是 Google 給 Gemini 3 Pro Image 起的產品名,模型 ID 為 gemini-3-pro-image。Nano Banana Pro 頁面從產品角度介紹的是同一個模型。
gemini-3-pro-image-preview 還能用嗎?+
Google 已於 2026 年 6 月 25 日關停該 preview ID。在 SeedRouter 上 gemini-3-pro-image-preview 仍被接受,並執行在 gemini-3-pro-image 上,所以你在切換 ID 期間舊程式碼照樣能跑。
Gemini 3 Pro Image 多少錢一張?+
在 Standard 通道,一張圖 $0.03,任何尺寸都一樣。在 Official 通道,按每次渲染回報的 token 付費,一次典型的 1K 或 2K 渲染約 $0.10304。價格部分按即時費率列出了每個尺寸的價格。
Gemini 3 Pro Image 免費嗎?+
Google 的價格頁面沒有為 Gemini API 上的 Gemini 3 Pro Image 列出免費層級。在 SeedRouter 上儲值一次,額度永不過期,失敗的請求不扣費。
我需要修改 Gemini 請求嗎?+
contents、systemInstruction、safetySettings 和 generationConfig 保持原樣即可。加一個 model 欄位,傳送到 /v1/images/generations,再從任務中讀取 Gemini 3 Pro Image 的結果。
怎麼取得 Gemini 3 Pro Image 的 API Key?+
登入,儲值任意金額,然後在 API Key 頁面建立一把 key。同一把 key 可以呼叫 Gemini 3 Pro Image 和這裡的所有其他模型。
Gemini 3 Pro Image 可以關閉思考嗎?+
不可以。Gemini 3 Pro Image 總是先思考再出圖。你可以用 includeThoughts 請求回傳思考摘要,思考 token 只在 Official 通道計費。
Gemini 3 Pro Image 和 Gemini 3.1 Flash Image 該選哪個?+
複雜指令和專業素材,用 Gemini 3 Pro Image。Gemini 3.1 Flash Image 更快,額外支援 512px 輸出和極端寬高比,還能讀取影片和 PDF 參考。
傳送你的第一個 Gemini 3 Pro Image 請求
先在 Playground 裡試用 Gemini 3 Pro Image,再把同一份 JSON 貼進你的程式碼。
