云凡智联

首页/开放能力

videoSubtitleRemoval

视频去字幕

使用火山 AI MediaKit 擦除视频画面中的硬字幕，支持标准版和精细化版。

标准版 10 / 精细化版 20 积分/分钟

基础说明

使用火山 AI MediaKit 擦除视频画面中的硬字幕，支持标准版和精细化版。

提交任务

提交火山 AI MediaKit 视频去字幕任务，自动识别并擦除画面中的硬字幕。

POST/api/third-party/videoSubtitleRemoval/generate

请求头

字段	类型	必填	说明
X-API-Token	string	是	平台提供的调用凭证，用于识别当前账号或租户。
Content-Type	string	是	提交任务时固定使用 application/json。

请求参数

字段	类型	必填	说明
video	string	是	公网可访问的 HTTP/HTTPS 视频 URL；输入最高 2K，输出最高 1080P。
durationSeconds	number	是	原视频时长（秒），范围 1-86400，用于按分钟向上取整计费。
version	string	否	standard（默认）或 professional；精细化版对复杂背景的擦除效果更好。
modelVersion	string	否	仅精细化版有效，v4 或 v5（默认）。

请求示例

bash

curl -X POST "https://yunfanzhilian.com/api/third-party/videoSubtitleRemoval/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{"video":"https://your-cdn.com/source.mp4","durationSeconds":60,"version":"standard"}'

响应字段

字段	类型	必填	说明
code	number	-	业务状态码，200 表示请求成功。
message	string	-	本次请求的结果说明。
data.taskId	string	-	任务 ID。提交成功后请保存，用于查询生成结果。
data.cost	number	-	本次提交预扣积分。
data.status	string	-	任务初始状态，通常为 pending 或 processing。
timestamp	string	-	响应时间，ISO 8601 格式。

响应示例

json

{
  "code": 200,
  "message": "视频去字幕任务已提交",
  "data": {
    "taskId": "task_xxxxxxxx",
    "status": "pending",
    "version": "standard",
    "chargedMinutes": 1,
    "costPerMinute": 10,
    "cost": 10
  }
}

注意事项

标准版 10 积分/分钟，精细化版 20 积分/分钟；durationSeconds 向上取整到分钟，任务失败自动退款。
火山官方成本为标准版 0.4 元/分钟、精细化版 1 元/分钟。
上游结果视频链接有效期为 24 小时，请及时下载保存。
提交后使用 GET /api/third-party/videoSubtitleRemoval/result/{taskId} 或统一结果接口轮询。