去水印

自动识别并去除视频中的水印、Logo、硬字幕等不需要的叠加元素，支持全屏净化、仅字幕区域净化、自定义区域净化，以及 ffmpeg / raft 两种去水印算法。

示例效果

subtitle 模式

full_screen 模式

创建任务

基本信息

项目	值
请求方法	POST
请求路径	/task/video_purify
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传视频文件的 ID
purify_scope	string	否	"full_screen"	净化范围：full_screen（全屏检测去除所有水印）/ subtitle（仅净化字幕区域）/ custom（仅净化 roi 指定区域）
roi	object	custom 时必填	—	自定义净化区域，归一化坐标（0-1 画面比例）：{"x","y","w","h"}，需 w>0、h>0、x+w≤1、y+h≤1
purify_func_type	string	否	"ffmpeg"	去水印算法：ffmpeg（默认，更快）/ raft（神经网络修复，效果更好，仅支持 20 分钟以内视频）

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/video_purify \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "purify_scope": "subtitle",
    "purify_func_type": "raft"
  }'

custom 模式示例（仅净化底部 20% 区域）：

curl -X POST https://api.ai-mcn.tv:10000/task/video_purify \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "purify_scope": "custom",
    "roi": {"x": 0.0, "y": 0.78, "w": 1.0, "h": 0.2}
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "video_purify",
    "status": "queued"
  }
}

---

查询任务结果

基本信息

项目	值
请求方法	GET
请求路径	/task/video_purify/{task_id}
鉴权方式	Authorization 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
file_id	string	处理后的视频文件 ID

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248"
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:01:00Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6016	400	purify_func_type / purify_scope 非法，custom 模式 roi 缺失或非法，或 raft 模式视频时长超过 20 分钟	检查 purify_func_type / purify_scope / roi，并确保 raft 模式视频不超过 20 分钟
6014	400	文件类型与接口不匹配	传入视频文件
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值