將 MaxAPI 圖片 API 接入 n8n，避免重複提交
使用 HTTP Request 與憑證管理，分開設定手動提交和狀態查詢，明確處理任務狀態。
技術核對日期:
1. 使用憑證管理保存授權
建立 HTTP Header Auth 憑證，Name 設 Authorization，Value 設 Bearer YOUR_MAXAPI_KEY，只在憑證編輯器內替換真正金鑰。HTTP Request 節點選 Generic Credential Type → Header Auth，指定已保存的憑證。不要把金鑰放進網址、Code 節點、JSON 本文或截圖。先在 Console 確認模型權限、綁定路由與餘額；執行紀錄可能包含提示詞和私人結果網址，應限制工作流程的存取權限。
2. 透過手動工作流程提交一次
建立 Manual Trigger → HTTP Request 流程，向 POST https://api.maxapi.dev/v1/images/generations 傳送下方 JSON，先只輸入一筆資料。回應格式選 JSON，Never Error 關閉，停用重新導向並保留 SSL 驗證。此 POST 不啟用自動重試或分頁。只有確實要生成一張圖時才執行，並把回傳的 id 和 poll_url 存入自己的工作紀錄；不要為了重新查詢狀態而再次執行此流程。
{
"model": "google/gemini-3.1-flash-lite-image",
"prompt": "A red ceramic bowl on a cream background, soft studio light.",
"resolution": "1K",
"aspect_ratio": "1:1",
"n": 1,
"async": true
}3. 使用另一個僅 GET 的流程查詢狀態
另建第二個流程，使用自己的 Manual Trigger 與 HTTP Request GET 節點，選同一憑證。使用已保存的 poll_url 前，確認為 HTTPS、主機 api.maxapi.dev，以及 /v1/images/generations/{id} 等圖片任務路徑。相對路徑必須以固定 API 網域解析；其他主機或重新導向應拒絕，不能轉送金鑰。這個流程不得包含生成 POST，確保查詢狀態不會再次觸發前面的提交節點。
4. 依任務狀態分流，而不只看 HTTP 成功
預設僅回應本文的 JSON 輸出，直接查看 status；若開啟 Include Response Headers and Status，應改查 body.status。queued／running 表示等待後再 GET；succeeded 才查看 data；failed 記錄錯誤並停止。遇到未知狀態也應停止檢查。提交 202 或查詢 200 都不是圖片完成的證據；從其他圖片主機下載結果時，節點不能帶 MaxAPI 憑證。
5. 排程與批次處理前先設定上限
自動化前，先持久保存工作歸屬、已受理的任務 ID 與提交狀態。分別限制 GET 次數、等待時間和 worker 並發；達到本地上限不會取消伺服器任務。POST 後逾時是結果不明，重新提交前應查紀錄。區分 401／403 權限、429 限流與終止性政策錯誤，不要遇錯就重播；復原流程及費用上限測好前，保持自動觸發關閉。本文不宣稱 n8n 或 MaxAPI 自帶自動去重保證。
各模型參數
這是公開設定快照，不代表即時可用性。參數、支援路由與參考圖限制請查看各模型頁面。
- 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