550W API 去除影片字幕與浮水印

550W 開發者 API 實際支援的項目

550W 開發者 API 可讓後端提交影片字幕或文字去除任務以及圖片浮水印移除任務，無需將用戶引導至手動編輯器。此 API 專為創作者平台、在地化流程、媒體庫及內部工具設計，適用於反覆處理組織擁有或已取得編輯授權的內容。

影片字幕與文字去除

對於影片，可透過 /open/uploadVideo 上傳 MP4 或 MOV 素材，或向 /open/submitTask 提供公開的 videoUrl。請求需包含影片尺寸、時長及修復區域。影片任務以非同步方式執行，可透過 /open/taskDetail 或 /open/taskList 進行查詢。

圖片浮水印移除

對於圖片，/open/removeImageWatermark 接受 JPG、PNG、BMP、WebP、AVIF、TIFF 或 SVG 檔案，大小上限為 50 MB。可選擇等待結果或返回處理任務供後續查詢。Eraser 開發者 API 不提供影片連結浮水印下載功能，因此整合時不應對此能力作出承諾。

使用 API 處理已授權的影片字幕與文字清理以及圖片浮水印移除；請勿將不支援的影片連結浮水印工作流程納入產品承諾中。

可投入生產環境的請求流程

每個請求都需以 userNo 與 apiKey 進行驗證。請將這兩個值保留在您的伺服器上：將 API 金鑰放在瀏覽器或行動用戶端程式碼中會使其可被用戶和擴充功能復原。影片可先上傳，或以公開可達的 HTTPS URL 形式提供。

驗證並上傳

提交 /open/submitTask 時需附上 width、height、duration 以及 x1、y1、x2、y2。精確的矩形區域通常比全螢幕修復能保留更多細節。當支援的工作流程需要保守的重建方式時使用 mode=protect，並僅在需要在處理前去除音軌時使用 removeAudio。

提交具有冪等性的任務

發送不超過 128 個字元的 Idempotency-Key 以確保可安全重試的創建作業。若在提交後連線中斷，請使用相同的金鑰重試，而非建立第二個可計費任務。請將返回的 taskId 與您自己的素材 ID 一同儲存。

接收並驗證結果

若要非同步接收通知，請提供公開的 HTTPS callbackUrl。當任務達到最終狀態時會觸發 webhook。您的處理程式應快速回覆，再次透過 /open/taskDetail 驗證任務，並將重複的 webhook 傳遞視為正常現象。當回呼延遲時，輪詢仍可作為復原路徑使用。

伺服器端憑證、冪等性、持久的任務 ID 以及 webhook 驗證可使重試安全且可觀測。

輸入限制與品質控制

上傳的影片支援 MP4 和 MOV，檔案大小上限為 1 GB、時長最長 600 秒、在符合規範的尺寸規則下處理最高 1080p。請在提交前驗證格式、時長、尺寸、色彩深度及 HDR 狀態，避免不支援的媒體進入付費佇列。

在消耗點數前進行驗證

品質取決於字幕或文字背後的移動內容。平坦的牆面、天空及緩慢變化的景色通常比手部、頭髮、花紋服裝、反射或快速攝影機移動更容易處理。為邊緣案例建立審查佇列，並比較整個時間軸，而非僅查看縮圖。

審查困難的素材

圖片任務支援常見的網頁與設計格式，並根據目前的 API 頁面按成功任務收取固定點數。請保留來源檔案並將結果儲存為衍生作品；浮水印移除不會產生版權或商業使用許可。

及早拒絕不支援的輸入，並在修復區域涉及重要移動細節時要求人工審查。

計費、失敗與重試政策

影片字幕移除依時長與解析度計費。目前的費率為 720p（含）以下每秒 1.3 點，超過 720p 至 1080p 為每秒 1.6 點。因此 30 秒 1280×720 影片約為 39 點，而 30 秒 1920×1080 影片約為 48 點。在接受大量批次前請先查詢 /open/queryCredits。

在提交前估算費用

成功的回應包含 code 與 message；任務回應還會額外顯示 status，並在完成時顯示 resultUrl。失敗的任務可能包含 failCode、failReason 及 refundStatus。對於暫時性的傳輸或內部失敗，請以指數退避方式重試，但請勿盲目重試無效參數、不支援的媒體、已停用的帳戶或點數不足的錯誤。

處理穩定的失敗欄位

記錄提交延遲、完成延遲、失敗率、審查拒絕率及每個已核准素材的費用。這些指標可揭示自動化是否正在改善工作流程，而非僅是將手動工作移至下游。

有用的整合會衡量已核准的輸出與有效成本，而非僅計算成功的 HTTP 回應。

四步驟啟動整合

首先，從當地化的 550W 開發者頁面產生 API 金鑰並提交一個代表性的影片。其次，實作任務查詢功能，在您的產品中顯示等待、處理中、成功及失敗的狀態。第三，加入冪等性與帶有輪詢復原的 webhook。第四，執行受控的批次並在增加併發量前審查每個輸出。

在擴展前先進行試點

使用獨立的開發和生產控制環境、輪換暴露的憑證、限制對來源媒體的存取，並為結果保留刪除政策。擁有明確驗收標準的團隊可以將 API 連接至 DAM、CMS、在地化佇列或創作者上傳工作流程，而不會犧牲編輯審查。