视频擦除(字幕 / 水印 / 台标)

两种模式

同一批 eraseRatioLocation 在两种模式下含义完全不同,这是最容易踩错的地方:在 auto 模式下框住一个没有文字的 logo,结果是毫无变化——因为框内没有可识别的文字。要擦非文字的东西,必须切到 manual。

实测(2026-10-18,合成素材):半透明文字水印 "@demo_channel" 用 manual 框住能干净去掉,auto 配 eraseType: "text" 也能去掉;但一块纯色方块图形 logo,即使框比它大 30-50%,manual 也基本没动。图形 logo 先拿一小段试,别直接跑整片。

创建任务

POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。

# ── Region mode — remove a watermark / corner logo ──────────────────────
# Box the mark with normalized 0-1 coordinates (fractions of width/height).
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "subtitle-erase",
    "video_url": "https://example.com/clip-with-watermark.mp4",
    "eraseMode": "manual",
    "eraseRatioLocation": [
      { "topLeftX": 0.70, "topLeftY": 0.02, "bottomRightX": 1.0, "bottomRightY": 0.20 }
    ]
  }'

# ⚠️ Draw the box GENEROUSLY — about 30-50% larger than the mark itself.
# A box cropped tight to the mark very often returns the video unchanged.
# For a corner logo, run the box out to the frame edges as above.

# ── Automatic mode — remove hardcoded subtitles (no box needed) ─────────
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "subtitle-erase",
    "video_url": "https://example.com/clip-with-subtitles.mp4",
    "eraseType": "subtitle"
  }'

# Poll until state == "completed" — data.resultUrls[0] is the cleaned video.
# Result files are kept 30 days.
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

参数名驼峰和下划线两种写法都收:eraseMode / erase_mode、eraseType / erase_type、eraseRatioLocation / erase_ratio_location、clipFilter / clip_filter;同时给了两种以驼峰为准。clipFilter.mode 不区分大小写。

失败时返回什么

• 建单时就被拒:HTTP 状态码即错误码,返回 { code, msg }。400 = 参数不对(缺 video_url、取值非法、manual 模式没给区域框)或读不到视频时长(链接不公开 / 已失效);401 = API Key 无效;402 = 余额不足。这些情况不会创建任务、不扣费。
• 建单成功、处理中失败:轮询 GET ?task_id= 仍返回 HTTP 200 和 code 200,失败信息在 data 里 —— data.state 为 "failed",data.failCode / data.failMsg 说明原因,data.credits 为 0(已全额退款),data.retryable 表示值不值得重试。常见原因:源视频导入失败(链接在处理期间失效)、处理超过 60 分钟超时。配了 callback_url 的,回调里是同样的 data。

计费与限制

• $0.015 每秒,按【输入视频时长】计,仅成功扣费、失败退款。30 秒 = $0.45,3 分钟 = $2.70。
• 用 clipFilter 只处理一段【不会降价】——整个文件仍要解码和重新编码。
• 处理时长以分钟计:30–60 秒的片子通常 10 分钟左右,多数在 16 分钟内,偶尔更久。时间几乎全花在逐帧文字检测与修复上,不是排队——属正常耗时,不是任务卡死。建议用 callback_url,不要长时间轮询等待。
• 时长没有硬性上限,但任务 60 分钟内没完成会按超时失败(全额退款)。建议单条不超过 60 秒;更长的视频先切成 60 秒以内的片段分别提交。
• 源视频 URL 需在整个任务期间保持可访问;预签名 URL 的有效期请不要短于 30 分钟(导入通常几秒完成,但 URL 一旦过期任务即失败)。
• 输出分辨率与输入一致,超过 1080p 按 1080p 输出。
• 结果文件保留 30 天,请及时下载或转存。
• 位置固定的水印最顺;会移动的可以给多个框覆盖轨迹,或用 clipFilter 分时段处理。在整幅画面里大范围游走的水印不适合。
• 去水印是否合法取决于素材本身,判断在你:处理自己的片子或已获授权的素材属于常规后期,去掉他人版权作品上的标记再发布不是。

相关