gemini-3-pro-image API

使用準確的型號 ID gemini-3-pro-image。模型欄位必須與此頁面完全相符。

範例輸出gemini-3-pro-imagePOST /v1beta/models/gemini-3-pro-image:generateContent

參數： size=2Kratio=16:9

提示詞： Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text.

產生此樣本的請求

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

身份驗證與端點

將 Modelflare API 金鑰與 https://modelflare.dev 結合使用。網關入口點是POST /v1/models/{model}:generateContent。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

生成影像

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

請求備註

Gemini影像模型使用原生contents和generationConfig；編輯傳送文字指令和inline_data在同一個parts[]中。

請求參數

Gemini 影像模型使用原生 Gemini generateContent。將文字和參考影像放在同一個contents[].parts[]中；影像使用 inline_data。請勿將這些模型發送到 /v1/images/generations、/v1/images/edits 或 OpenAI /v1/responses。 imageSize 枚舉是特定於模型的，如下所示。

場	必填	註釋
contents[].parts[].text	是	文字提示或編輯指令
contents[].parts[].inline_data	否	Base64影像資料與MIME類型
contents[].parts[].inline_data.mime_type	否	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	否	Base64編碼的參考影像內容
generationConfig.responseModalities	是	["IMAGE"] 或 ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	否	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	否	1K / 2K / 4K

回應與輸入限制

Pro 支援 1K、2K 和 4K 以及 1:1、4:3、3:4、16:9 和 9:16。官方文件沒有發布參考圖像計數上限，因此網關沒有添加本地上限。

影像編輯範例

將編輯指令和參考影像放在同一個contents[].parts[]中。 inline_data.data為Base64影像內容；請勿將 Gemini 影像模型傳送至 OpenAI 影像或 Responses 端點。

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

響應形狀

讀取candidates[].content.parts[]；不要假設每個部分都是圖像，因為回應可能同時包含文字和圖像部分。

場	註釋
candidates[].content.parts[].inline_data	產生的影像MIME類型與Base64數據
candidates[].content.parts[].text	請求 TEXT 時返回文字標題
candidates[].finishReason	完成或安全原因
usageMetadata	服務返回時的輸入/輸出令牌使用情況

Modelflare 保留 gemini-3-pro-image 的原生 Gemini 響應形狀並保留可用的影像部分。

錯誤與失敗的任務

來自本機 Gemini 請求的欄位錯誤、大小/比率限制和安全拒絕仍然是與 Gemini 相容的錯誤回應。網關不會將它們重寫為 OpenAI Images 回應。

支援範圍

此頁面涵蓋 Modelflare 模型產生和編輯呼叫。搜尋或地圖豐富、語音管理和元素庫管理是此公共模型呼叫表面之外的資源 API，並且不是必需的請求欄位。

定價與計費

此模型使用基於令牌的計費。請參閱 型號定價頁面 ，以了解當前客戶價格、參考標價和完整規格。

注意

此頁面記錄了 Modelflare 的公共介面；此處顯示的欄位和限制是目前合約。