正確傳送參考圖，避免輸入錯誤
選擇圖片編輯端點、維持參考圖順序、驗證真實圖片檔案，確認各模型限制後再增加輸入數量。
技術核對日期:
參考圖使用編輯端點
MaxAPI 的 POST /v1/images/edits 接受 JSON 網址參考圖。單張使用 image_url，多張使用有順序的 image_urls，並提供 model、prompt 與該模型的輸出參數。這是 MaxAPI 格式，不代表所有上游 SDK 都使用相同 JSON。首次測試先用一張自己有權使用且不含敏感資訊的圖片，以支援的小解析度輸出一張。
{
"model": "google/gemini-3.1-flash-image-preview",
"prompt": "Keep the product from image 1; use the background colors from image 2.",
"image_urls": ["https://YOUR_ASSET_HOST/product.png", "https://YOUR_ASSET_HOST/background.png"],
"resolution": "1K", "aspect_ratio": "1:1", "n": 1, "async": true
}檢查內容，不只看副檔名
將占位網址換成實際可取得的 HTTPS 圖片網址。即使以 .png 結尾，登入頁、HTML 錯誤頁、過期簽名網址或空檔案都不是有效圖片。在本地解碼檔案，檢查尺寸與格式。如果上游拒絕特殊色彩模式或損壞檔案，可把自有原圖重新匯出為一般 RGB PNG 或 JPEG 再驗證。轉檔是診斷步驟，不保證修復所有 400。
明確定義順序與限制
在提示詞中說明各圖角色，例如圖 1 提供商品、圖 2 提供配色，修正請求後仍維持陣列順序。不要假設所有 Nano Banana 或 GPT Image 版本都支援 14 張參考圖；Lite 與其他系列限制不同，所選路由也需要支援編輯。請以各模型頁面為準，不要套用單一全域上限。
找出出錯的參考圖
若錯誤指出 image 1，先檢查第一張輸入與其實際下載回應。先建立單張參考圖基準，再逐步加入其他有權使用的圖片並記錄順序。檔案驗證與提示詞／內容政策處理必須分開：451 不等於圖片格式無效，502 也不能單獨證明參考圖數量不支援。分享診斷資訊前，遮蔽私人圖片網址與提示詞。
各模型參數
這是公開設定快照，不代表即時可用性。參數、支援路由與參考圖限制請查看各模型頁面。
- Gemini 3.1 Flash Lite Image
google/gemini-3.1-flash-lite-image - Gemini 3.1 Flash Image Preview
google/gemini-3.1-flash-image-preview - Nanobanana Pro
google/gemini-3-pro-image-preview - GPT Image 2
openai/gpt-image-2