google/gemini-3.1-flash-image-preview

接入前必讀

以下參數依據 MaxAPI 公開配置；所選路由可能另有輸入或權限要求。

請求模型 ID

google/gemini-3.1-flash-image-preview

輸出類型

圖片

Base URL

https://api.maxapi.dev

生成方式

同步回傳或非同步任務

參考圖片・本站配置上限

14

解析度與尺寸

512 / 1K / 2K / 4K · aspect_ratio + resolution

參考素材必須是真實圖片，不可使用 HTML 錯誤頁、PDF 或只改副檔名的檔案。請確認檔案完整且可解碼；檔案體積小，也可能有過大的像素尺寸。先測通單張參考圖，再增加至完整組合。

模型特點與選型

資料核對 · 2026-09-10

此模型的資料來源: Google · gemini-3.1-flash-image · Google · Nano Banana image generation

何時值得選擇它

商品素材需要方形、直式、橫向多版位，或需要草稿到成品的多解析度流程時，可優先納入比較。非常複雜的版式，則應與 Pro 的合格結果一起評估。

限制與注意事項

較小草稿不等於之後 4K 成品的固定縮圖。每次輸出都需檢查裁切與主體細節；官方圖片搜尋能力不代表本站已提供，本站含 preview 的公開 ID 也不改。

供應商能力描述的是模型本身，不等於 MaxAPI 已開通全部功能。本站接入以此入口列出的參數、輸入類型和路由為準；供應商的速度、品質定位不是服務保證。

MaxAPI 實際如何處理請求

路由與價格

公開路由：official、official-cheap、mix。圖片／影片 JSON 請求可指定 route_mode；Gemini 原生請求使用 X-MaxAPI-Route-Mode。受限路由需帳戶與 API Key 同時具備權限。路由代表接入與計費選擇，不是另一個公開模型 ID。

1 積分 = 1 美元。此處為目錄基礎價格，並非帳戶即時報價；最終消耗依帳戶倍率與生效計費配置結算。Token 單價不等於每張圖片固定價格。

第一次呼叫

建立 MaxAPI API Key，並在服務端環境中設定 MAXAPI_KEY，請勿將金鑰放入瀏覽器程式碼。範例未指定路由時，依 API Key 的路由配置處理。

• POST /v1/images/generations
• POST /v1/images/edits
• GET /v1/images/generations/{task_id}
• GET /v1/images/edits/{task_id}
• POST /v1beta/models/gemini-3.1-flash-image-preview:generateContent (Gemini-native)
• GET /v1beta/operations/{task_id} (async polling for the Gemini-native endpoint)

同步呼叫會等待生成結果。非同步圖片生成可在 JSON 內加入 async: true；Gemini 原生請求使用 X-MaxAPI-Async: true。保存回傳任務 ID，再輪詢上方對應的 GET 端點。

curl -X POST "https://api.maxapi.dev/v1/images/generations" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "prompt": "a clean product photo of a glass cube",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

curl "https://api.maxapi.dev/v1/images/edits" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -F "model=google/gemini-3.1-flash-image-preview" \
  -F 'prompt=Keep the product unchanged and replace the background with a soft gray studio backdrop.' \
  -F 'image=@reference.png' \
  -F 'aspect_ratio=1:1'

{
  "id": "example-task-id",
  "object": "image.generation.task",
  "status": "queued",
  "model": "google/gemini-3.1-flash-image-preview",
  "poll_url": "/v1/images/generations/example-task-id"
}

先看現象，再判斷錯誤原因