550W Video Eraser API：處理影片字幕、浮水印與圖片浮水印

先了解 API 支援的工作

550W 開發者 API 可由伺服器提交獲授權的影片字幕／文字處理任務，或依指定矩形處理可見浮水印，也支援圖片浮水印處理。API 權限不代表取得素材權利，完成結果仍須人工檢查。

影片字幕與浮水印處理

MP4 或 MOV 影片可先透過 /open/uploadVideo 上傳，也可以將外部可存取的 HTTPS videoUrl 傳給 /open/submitTask。請求需包含畫面尺寸、片長與處理區域的座標。影片工作以非同步方式進行，狀態可從 /open/taskDetail 或 /open/taskList 查詢。

圖片浮水印移除

/open/removeImageWatermark 接受 JPG、PNG、BMP、WebP、AVIF、TIFF 與 SVG，現行每張圖片上限為 50 MB。它可能回傳結果，也可能提供稍後查詢的工作編號。此 API 沒有透過影片連結下載檔案並移除浮水印的功能。

只將 API 接到有權處理的影片文字與圖片浮水印工作，不宣稱不存在的影片連結功能。

建立能安全重新提交的流程

每筆請求都要使用 userNo 與 apiKey。兩者應存放在自己的伺服器，不要寫進瀏覽器或行動 App 程式碼。影片可先上傳，也可提供公開可連線的 HTTP(S) 位址。

把帳號資訊留在伺服器

提交 /open/submitTask 時帶入 width、height、duration 和 x1、y1、x2、y2。Standard（mode=normal，預設）處理所選矩形內部；Protect（mode=protect）保留內部並處理外部，並非提高畫質的設定。只有在處理前確實需要移除音訊時才使用 removeAudio。

以冪等鍵提交工作

建立工作時請附上長度不超過 128 字元的 Idempotency-Key。若送出後連線中斷，重試同一件工作時沿用原鍵，避免多建一筆可能扣點的工作。將回傳的 taskId 與內部素材編號一起儲存。

收到通知後再查證結果

如需完成通知，可提供公開 HTTP(S) callbackUrl。收到回呼後應迅速回應，再用 /open/taskDetail 核對狀態；重複通知也要能安全處理。通知延遲時，仍需有輪詢作為備援。

伺服器端憑證、冪等鍵、持久化的工作編號和回呼後查證，讓重新提交有跡可循。

送出前檢查輸入，完成後檢查畫面

開發者 API 的影片限制與瀏覽器上傳流程不同。請依目前 API 頁面核對格式、片長、解析度、位元深度及 HDR 狀態，再送出素材，避免不支援的檔案進入處理流程。

依當前 API 條件驗證素材

字幕後方如果有手、頭髮、花紋布料、反光或快速鏡頭移動，成品比單色牆面或天空更難判斷。為這類情況安排人工檢查，觀看整支輸出影片，不能只看縮圖。

複雜動態畫面交由人工覆核

圖片處理成功後的點數以現行 API 頁面說明為準。保留原圖，將處理結果另存為衍生檔。能夠技術性地移除浮水印，不等於取得著作權或商業使用授權。

事先排除不支援的輸入；處理區域穿過重要移動細節時，應由人看完整輸出。

估算費用並分辨失敗原因

影片字幕處理依片長與解析度扣點。現行 API 頁面列出：720p 以下每秒 1.3 點，超過 720p 至 1080p 每秒 1.6 點。30 秒影片分別約需 39 點或 48 點。大量送件前請查 /open/queryCredits，並重新確認最新費率。

大量提交前先查點數

保留回應中的 code 與 message、工作 status，以及完成後的 resultUrl。失敗時若有 failCode、failReason、refundStatus，也要一併查看。暫時性的連線問題可拉長間隔重試；參數錯誤、不支援素材、帳號停用或點數不足則須先處理原因。

依錯誤種類決定是否重試

記錄提交到完成所需時間、失敗比例、人工退件比例與每件獲准成品的成本。單看 HTTP 成功次數，無法知道審核工作是否被轉移到後續流程。

以人工批准的成果與實際成本衡量整合，而非只看請求成功。

先完成小批次試行

在 550W 開發者頁面建立 API 金鑰，先送出一段有代表性的影片。實作工作查詢並顯示等待、處理中、成功和失敗狀態，再加入冪等鍵、回呼及備援輪詢。檢查一小批素材的每個結果後，才增加同時進行的工作數。

驗證全流程後再提高並行量

區分開發與正式環境管理，輪替外洩的金鑰，限制原始素材的存取，並訂出成果刪除規則。接入 DAM、CMS 或在地化佇列時，仍須保留明確的驗收標準與人工發布核准。