550W Video Eraser API：处理视频字幕、水印和图片水印

开发者 API 实际提供哪些能力

550W 开发者 API 允许服务端提交获授权的视频字幕/文字处理任务，或按指定矩形处理可见水印，也支持图片水印处理。API 权限不代表获得素材权利，完成后的结果仍需人工检查。

视频字幕与水印处理

视频可通过 /open/uploadVideo 上传 MP4 或 MOV，也可向 /open/submitTask 提供外部可访问的 HTTPS videoUrl。请求需要给出宽高、时长和待处理区域坐标。任务异步执行，可通过 /open/taskDetail 或 /open/taskList 查询。

移除图片水印

/open/removeImageWatermark 接受 JPG、PNG、BMP、WebP、AVIF、TIFF、SVG，当前单张图片上限为 50 MB。接口可能直接返回结果，也可能返回供后续查询的任务。它不提供从视频链接下载文件并去除水印的能力，不应把这项能力写进产品承诺。

把 API 用于获授权的视频文字与图片水印任务，不承诺接口没有提供的视频链接能力。

设计可安全重试的请求流程

每次请求均使用 userNo 和 apiKey。两项凭证应留在服务端，不要写入浏览器或移动应用代码。视频可以先上传，也可以提交公开可访问的 HTTP(S) 地址。

在服务端保管凭证并提交素材

向 /open/submitTask 提交 width、height、duration 与 x1、y1、x2、y2。Standard（mode=normal，默认）处理矩形选区内部；Protect（mode=protect）保留内部并处理外部，不是提高画质的模式。仅在处理前确需去除声音时使用 removeAudio。

使用幂等键创建任务

创建任务时附带不超过 128 个字符的 Idempotency-Key。如果提交后连接中断，重试同一业务任务时沿用原键，避免生成第二个可能扣费的任务。把返回的 taskId 与内部素材 ID 一同持久保存。

收到完成通知后重新确认

可提供公网 HTTP(S) callbackUrl 接收最终状态通知。回调处理程序应尽快响应，并通过 /open/taskDetail 再次核对任务状态；重复通知也应安全处理。保留轮询作为通知延迟时的恢复途径。

服务端凭证、幂等键、持久任务编号与回调后二次查询共同保障可追踪的重试。

先核对输入条件，再检查结果

开发者 API 的视频输入条件与浏览器上传流程不同。提交前以当前 API 页面为准，核验文件格式、时长、分辨率、位深与 HDR 状态，避免不受支持的素材进入处理队列。

避免不受支持的素材进入流程

字幕背后的画面会影响结果。平面墙壁或天空通常比手部、头发、花纹衣物、反光与快速镜头运动容易检查。应为复杂素材安排人工复核，观看完整输出而非只看缩略图。

重点检查复杂运动区域

图片任务成功后的积分消耗以当前 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 或本地化队列时，仍要保留明确的内容验收标准与人工发布审批。