MaxAPI / API 文件

開發者指南

先完成一次圖片請求，再保存任務 ID、驗證輸入，了解路由與計費後逐步增加流量。

使用 Python 生成圖片

使用 Python 標準函式庫提交一個 MaxAPI 圖片任務、輪詢狀態，避免盲目重送造成重複生成。

不依賴第三方套件的 Node.js 範例，使用原生 fetch、有限次輪詢與明確錯誤處理，不自動重送 POST。

理解 HTTP 202、排隊與執行狀態、成功結果、失敗任務，以及客戶端逾時後的恢復方式。

選擇圖片編輯端點、維持參考圖順序、驗證真實圖片檔案，確認各模型限制後再增加輸入數量。

不要將 4K 或 high 品質設定直接套用不同模型；輸出參數必須符合所選 MaxAPI 模型與端點。

區分請求速率與並行數，避免無限重試，將任務輪詢與新生成提交分開控制。

分開連線、認證、輸入、餘額、政策與上游錯誤；HTTP 成功本身不代表任務成功。

把公開價格視為目錄，確認帳號實際權限，並區分暫時預留積分與已結算消費。

比較五個 MaxAPI 圖片模型的參考圖上限、輸出設定與公開路由，再用相同授權素材確認品質與實際費用。

使用 HTTP Request 與憑證管理，分開設定手動提交和狀態查詢，明確處理任務狀態。