MaxAPI / API 文件

開發者指南

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

使用 Python 生成圖片

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

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

區分 api.maxapi.dev 的 HTTP 202 與 async.maxapi.dev 的 HTTP 200，了解任務狀態及避免重複提交的恢復方式。

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

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

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

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

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

使用相同提示詞與參考圖比較初代、Pro、2、2 Lite、2.1，檢查原圖、中文字、實際尺寸及 Mix 結算費用。

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

使用 MaxAPI 金鑰呼叫 /v1beta/interactions，從 curl 開始，接收原生串流事件、延續已儲存對話並確認目前功能限制。

以相同提示詞比較商品照片與文字海報，附原圖、請求設定、實扣積分、完成耗時，以及未完全遵循的要求。

比較 GPT Image 2 與 Flare 的原始輸出、實扣費用及失敗請求。本輪 Sunburst 未返回圖片，尚無法評估畫質。