图片/视频擦除接口

更新时间：2026-07-14

服务概述

• 创建视频或图片文本擦除任务。
• 支持分页查询任务、批量查询任务状态。
• 任务为异步处理模式：创建任务后返回 taskId，客户端轮询 taskStatus 获取进度和结果 URL。

服务地址

https://video-translation.viitor.com

鉴权方式

Authorization: Bearer vt_live_xxx

公共响应结构

任务状态枚举

mediaType 枚举

1. 创建擦除任务

接入方式

• 请求 URL：https://video-translation.viitor.com/openapi/v1/video-text-removal/add
• 请求方法：POST
• Content-Type：application/json

HTTP 请求头

请求体字段

区域格式说明

textDetectROI、fullEraseROI 二者至少传入一个，二者均为二维数组，每个子数组表示一个矩形区域。坐标含义以业务处理服务约定为准，通常可按 [x1, y1, x2, y2] 传递。

成功时 data 字段

请求示例

curl -X POST "https://video-translation.viitor.com/openapi/v1/video-text-removal/add" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_live_xxx" \
  -d '{
    "url": "https://cdn.example.com/video/source.mp4",
    "taskName": "Text removal task 001",
    "mediaType": 1,
    "textDetectROI": [[100, 200, 800, 320]]
  }'

成功响应示例

{
  "code": 0,
  "message": "OK",
  "data": {
    "userId": 123456,
    "taskId": "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA",
    "mediaType": 1
  }
}

2. 分页查询任务

• 请求 URL：https://video-translation.viitor.com/openapi/v1/video-text-removal/pageList
• 请求方法：POST
• 请求头：同创建擦除任务接口

成功时记录字段：

请求示例

curl -X POST "https://video-translation.viitor.com/openapi/v1/video-text-removal/pageList" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_live_xxx" \
  -d '{
    "current": 1,
    "pageSize": 10,
    "mediaType": 1
  }'

成功响应示例

{
  "code": 0,
  "message": "OK",
  "data": {
    "current": 1,
    "size": 10,
    "total": 1,
    "pages": 1,
    "records": [
      {
        "taskId": "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA",
        "mediaType": 1,
        "duration": 30000,
        "targetVideoUrl": "https://cdn.example.com/video/result.mp4",
        "taskStatus": 4,
        "errorCode": 0,
        "taskName": "Text removal task 001",
        "taskProgress": 100,
        "createTime": 1720000000000
      }
    ]
  }
}

3. 查询任务状态

• 请求 URL：https://video-translation.viitor.com/openapi/v1/video-text-removal/taskStatus
• 请求方法：POST
• 请求头：同创建擦除任务接口

成功时 data 为数组：

请求示例

curl -X POST "https://video-translation.viitor.com/openapi/v1/video-text-removal/taskStatus" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_live_xxx" \
  -d '{
    "taskIds": [
      "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA"
    ]
  }'

成功响应示例

{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "taskId": "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA",
      "mediaType": 1,
      "taskStatus": 4,
      "taskProgress": 100,
      "errorCode": 0,
      "targetVideoUrl": "https://cdn.example.com/video/result.mp4",
      "updateTime": 1720000300000
    }
  ]
}

常见错误码