非同步圖片任務：提交一次，安全輪詢
理解 HTTP 202、排隊與執行狀態、成功結果、失敗任務，以及客戶端逾時後的恢復方式。
技術核對日期:
指定非同步回應
MaxAPI JSON 圖片端點可透過 async true 取得任務受理結果，不必等待長時間的生成回應。成功提交會回傳 HTTP 202，以及 id、status、poll_url。請先將它們與自己的工作 ID 一起保存，再標示提交完成。不要從模型名稱或供應商任務 ID 猜測輪詢路徑，使用 MaxAPI 實際返回的網址。
{
"model": "google/gemini-3.1-flash-lite-image",
"prompt": "A blue ceramic cup on a cream background.",
"resolution": "1K", "aspect_ratio": "1:1", "n": 1, "async": true
}以任務狀態判斷結果
輪詢使用 GET 與同帳號認證。範例將 submitted、queued、pending、running、processing 視為未完成，succeeded 才是成功終態。即使查詢返回 HTTP 200，failed 或 cancelled 也不是圖片生成成功。未知狀態應提示檢查，不能默認成功。結果可能包含圖片網址或 result_payload_url，不要假設每個回應都是 inline base64。
POST once → save id + poll_url
GET poll_url → queued/running → wait → GET again
→ succeeded → use result
→ failed/cancelled → inspect, do not silently resubmit分別限制生成與輪詢
五秒輪詢間隔只是範例起點，不是服務 SLA 或帳號限制。應分別限制查詢次數、網路逾時與 worker 數。瀏覽器重新整理時應載入既有任務，而不是重新提交。大量任務同時執行時，分散查詢時間；GET 失敗後保留任務 ID，不要為了恢復查詢而建立另一個生成任務。
客戶端逾時不代表任務取消
關閉分頁、取消 fetch 或用完本地輪詢次數，只是客戶端停止等待，不能證明伺服器停止處理或沒有消耗積分。有任務 ID 時恢復查詢或查看 Console 紀錄；初次提交結果不明時，先核對紀錄與 request ID。不要自行假設存在冪等保證，應保存自己的提交狀態並防止並行重複 POST。
各模型參數
這是公開設定快照，不代表即時可用性。參數、支援路由與參考圖限制請查看各模型頁面。
- 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 - GPT Image 2
openai/gpt-image-2