4oImageApi.io 只保留圖片 14 天,非同步生圖應以歸檔作為終點
將 4oImageApi.io 整合進設計後台的團隊,應把任務成功與素材交付分開:透過 taskId 追蹤狀態,並在 14 天保留期限內將結果存到自行管理的儲存空間。回呼可以通知完成,不能取代檔案歸檔。
設計後台串接 4oImageApi.io 後,收到生成完成通知,就能關閉任務嗎?如果這張圖片還要用於下個月的活動,答案是否定的。官方文件說明,生成的圖片只保留 14 天。非同步生成適合讓後台分開處理「送出請求」與「取得結果」,但團隊仍須補上自己負責的歸檔步驟。
這裡依據文件分析一項內部素材生成任務,並非實際 API 測試。假設設計師提出一張活動配圖的需求,開發者要交付的是能在自家素材庫重新開啟的圖片,而不只是伺服器顯示任務成功。
回呼通知完成,狀態查詢協助確認結果
文件說明,任務完成後會向指定的回呼網址發送 POST 通知;詳細資訊 API 則可透過 taskId 查詢生成狀態、參數與結果。整合時,應在自己的任務紀錄中,將這次配圖需求與 taskId 對應起來,讓後續查詢能追溯原始需求。
介面也應區分「生成中」與「可以交給設計師檢查」。官方列出 GENERATING、SUCCESS、CREATE_TASK_FAILED、GENERATE_FAILED 等狀態。收到通知後,須核對狀態與結果,才能決定繼續等待、處理失敗,或進入圖片檢查;不能把每一次通知都視為已取得可用素材。
若採用輪詢,文件規定每個任務每秒最多查詢 3 次。這是查詢上限,不是建議頻率,也不是每秒能生成 3 張圖片的承諾。團隊應依使用者的等待體驗安排查詢間隔,並在任務進入終止狀態時停止重複查詢,避免將狀態監控誤當成生圖吞吐量。
14 天保留期限,讓歸檔成為整合的一部分
對於下個月才會使用的配圖,只把供應商的結果網址記入試算表並不夠穩妥。既然圖片會在 14 天後失效,就應在保留期限內,將選定的結果存到自行管理的儲存空間,再把內部素材位置寫回任務紀錄。這項歸檔工作是整合方案必須實作的責任,不能從「支援回呼」推論產品會代為永久保存。
驗收可以圍繞同一項需求進行:確認結果能開啟、圖片符合設計要求、內部副本能獨立讀取,最後再將任務標為已交付。若生成成功但歸檔失敗,應保留兩種不同狀態,以便補做儲存,避免讓設計師誤以為素材已經入庫。這是一種建議的驗收設計,本文並未驗證其實際運作表現。
對於只需暫時預覽的內部實驗,團隊可以接受短期結果,但仍應告知使用者保留期限;一旦素材需要長期重複使用,就應先確定儲存位置與失敗處理責任,再擴大整合範圍。4oImageApi.io 的非同步能力提供分開處理等待與通知的方式,團隊的交付標準則應落在自己能持續取回的檔案上。
內容說明:本文基於公開資料整理,僅供工具選型參考。產品功能、價格及相關政策可能隨時調整,請以官方最新資訊為準。
原文出處:docs.4oimageapi.io