视频去水印API（VideoWipe）接入指南

接口速览

以下信息来自轻语API开放平台生产环境接口元数据，可直接用于技术选型评估。

请求参数

响应示例

成功响应（HTTP 200）

# 提交任务返回
{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "taskId": "wm_xxxxxxxx",   // 保存此ID用于查询
    "status": "processing"
  }
}

# 查询状态返回
{
  "code": 200,
  "data": {
    "taskId": "wm_xxxxxxxx",
    "status": "completed",     // processing / completed / failed
    "progress": 100,
    "videoUrl": "https://file.luanqing.net/.../result.mp4"
  }
}

调用示例

cURL 示例

# 1. 提交去水印任务（自动检测，高质量模式）
curl -X POST 'https://5555api.com/data/api/removeWatermarkV3' \
  -F 'apikey=YOUR_APIKEY' \
  -F 'file=@video.mp4' \
  -F 'mode=quality' \
  -F 'target=auto'

# 2. 查询任务状态
curl 'https://5555api.com/data/api/removeWatermarkV3/status?taskId=wm_xxxxxxxx&apikey=YOUR_APIKEY'

JavaScript 示例

// 1. 提交任务
const fd = new FormData();
fd.append('apikey', 'YOUR_APIKEY');
fd.append('file', videoInput.files[0]);
fd.append('target', 'watermark'); // 指定去水印，可选auto

const submit = await fetch('https://5555api.com/data/api/removeWatermarkV3', {
  method: 'POST', body: fd
}).then(r => r.json());
const taskId = submit.data.taskId;

// 2. 每3秒轮询一次，最多100次
for (let i = 0; i < 100; i++) {
  await new Promise(r => setTimeout(r, 3000));
  const st = await fetch(`https://5555api.com/data/api/removeWatermarkV3/status?taskId=${taskId}&apikey=YOUR_APIKEY`).then(r => r.json());
  console.log('进度:', st.data.progress + '%');
  if (st.data.status === 'completed') {
    console.log('结果视频:', st.data.videoUrl);
    break;
  }
  if (st.data.status === 'failed') throw new Error('处理失败');
}

Python 示例

import requests, time

# 1. 提交任务
with open('video.mp4', 'rb') as f:
    submit = requests.post(
        'https://5555api.com/data/api/removeWatermarkV3',
        data={'apikey': 'YOUR_APIKEY', 'target': 'auto'},
        files={'file': f}
    ).json()

task_id = submit['data']['taskId']

# 2. 轮询查询
for _ in range(100):
    time.sleep(3)
    st = requests.get(
        'https://5555api.com/data/api/removeWatermarkV3/status',
        params={'taskId': task_id, 'apikey': 'YOUR_APIKEY'}
    ).json()
    print('进度:', st['data'].get('progress'), '%')
    if st['data']['status'] == 'completed':
        print('结果视频:', st['data']['videoUrl'])
        break
    if st['data']['status'] == 'failed':
        raise SystemExit('处理失败')

应用场景

常见问题

相关 API 与开发资源

继续查看轻语API开放平台的接口分类和可直接体验的在线工具。