视频去字幕与图片去水印 API

550W 开发者 API 实际支持的功能

550W 开发者 API 允许后端提交视频字幕或文本擦除任务以及图片水印去除任务，而无需用户通过手动编辑器操作。它专为创作者平台、本地化流程、媒体库以及需要反复处理组织拥有或授权编辑内容的内部工具而设计。

视频字幕和文本擦除

对于视频，可以通过 /open/uploadVideo 提交 MP4 或 MOV 素材，或向 /open/submitTask 提供公共 videoUrl。请求中需包含视频尺寸、时长以及需要修复的矩形区域。视频任务异步运行，可通过 /open/taskDetail 或 /open/taskList 查询。

图片水印去除

对于图片，/open/removeImageWatermark 接受 JPG、PNG、BMP、WebP、AVIF、TIFF 或 SVG 文件，最大 50 MB。它可以等待结果返回，或返回一个处理任务供后续查询。Video Eraser 开发者 API 不提供视频链接水印下载功能，因此集成方不应承诺此能力。

使用 API 进行授权的视频字幕/文本清理和图片水印去除；请勿在产品承诺中包含不支持的视频链接水印工作流程。

生产就绪的请求流程

每个请求都通过 userNo 和 apiKey 进行认证。请将这两个值保存在您的服务器上：将 API key 放置在浏览器或移动客户端代码中，可能被用户和扩展程序获取。视频可以先上传，或提供一个可公开访问的 HTTPS URL。

认证并上传

提交 /open/submitTask 时需包含 width、height、duration 以及 x1、y1、x2、y2。紧凑的矩形区域通常比全屏修复能保留更多细节。当支持的工作流程需要保守重建时，使用 mode=protect；仅当处理前需要去除音频时，才使用 removeAudio。

提交幂等任务

发送一个不超过 128 个字符的 Idempotency-Key，以实现重试安全的创建。如果在提交后连接中断，请使用相同的 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 key，并提交一个代表性视频。其次，在您的产品中实现任务查询，并显示等待中、处理中、成功和失败状态。第三，添加幂等性以及带有轮询恢复机制的 webhook。最后，运行一个受控批处理，并在增加并发量之前审查每个输出。

规模化前进行试点

使用独立的开发和生产控制，轮换暴露的凭据，限制对源媒体的访问，并为结果保留删除策略。具有明确验收标准的团队可以将 API 连接到 DAM、CMS、本地化队列或创作者上传工作流程，而无需牺牲编辑审查。