xmsmartlink Docs

外观

视频字幕擦除 ​

概述 ​

视频擦除接口用于自动擦除视频中的字幕。接口为异步模式：提交任务后立即返回任务 ID，通过回调或查询接口获取处理结果。建议优先配置 callback_url 接收结果；如未配置回调，可定时轮询查询接口。

注意：仅支持使用 Seedance 2.0 生成的原始 URL，转存后无效。原始 URL 存在 24h 有效期，请及时处理。

定价 ​

本接口目前收费 ¥0.000015/次。

创建任务 ​

http
POST https://vip.xmsmartlink.com/api/v1/ark-tools/ark-erase-video-subtitle-pro

请求头 ​

参数名类型必填说明
Authorizationstring是格式为 Bearer <API_KEY>
Content-Typestring是固定为 application/json
X-Trace-IDstring否请求跟踪 ID，建议每次传入不同的随机 32 位字符串，便于问题排查

请求体 ​

字段类型必填默认值说明
video_urlstring是-待擦除字幕的视频 URL
callback_urlstring否-任务完成或失败时接收通知的 URL；也可通过请求头 X-Callback-URL 传入

参数详解 ​

video_url ​

待处理视频的 URL。仅支持使用 Seedance 2.0 生成的原始视频 URL，对视频进行转存或二次加工后 URL 将无法使用。原始 URL 自生成起有效期为 24 小时，请在有效期内提交任务。

callback_url ​

任务终态（成功或失败）时，平台将向该 URL 发送 POST 回调通知。支持在请求体中传入，也支持通过请求头 X-Callback-URL 传入；两者均传时以请求体为准。

示例：提交擦除任务 ​

bash
curl https://vip.xmsmartlink.com/api/v1/ark-tools/ark-erase-video-subtitle-pro \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/021.mp4",
    "callback_url": "https://your-server.com/webhook"
  }'

响应 ​

json
{
  "task_id": "task_xxxxxxxxxxxxxxxxxx",
  "request_id": "2026060302502678560004lfIzQNO"
}
字段类型说明
task_idstring平台任务 ID，用于查询任务状态
request_idstring请求唯一标识，可用于问题排查

查询任务 ​

http
GET https://vip.xmsmartlink.com/api/v1/ark-tasks/{task_id}

{task_id} 为提交任务时返回的 task_id。

状态变化：SUBMITTED → QUEUED → IN_PROGRESS → SUCCESS 或 FAILURE

示例 ​

bash
curl https://vip.xmsmartlink.com/api/v1/ark-tasks/task_xxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer sk-your-api-key"

进行中 ​

json
{
  "task_id": "task_xxxxxxxxxxxxxxxxxx",
  "request_id": "2026060302502678560004lfIzQNO",
  "status": "IN_PROGRESS"
}

已完成 ​

json
{
  "task_id": "task_xxxxxxxxxxxxxxxxxx",
  "request_id": "2026060302502678560004lfIzQNO",
  "status": "SUCCESS",
  "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/021.mp4"
}
字段类型说明
task_idstring平台任务 ID
request_idstring请求唯一标识
statusstring任务状态，见状态说明
video_urlstring擦除字幕后的视频 URL，仅 SUCCESS 时返回

失败 ​

json
{
  "task_id": "task_xxxxxxxxxxxxxxxxxx",
  "request_id": "2026060302502678560004lfIzQNO",
  "status": "FAILURE",
  "fail_reason": "task failed"
}

回调 ​

配置 callback_url 后，任务到达终态（SUCCESS 或 FAILURE）时，平台将向该地址发送 POST 请求。

请求体 ​

成功

json
{
  "task_id": "task_xxxxxxxxxxxxxxxxxx",
  "request_id": "2026060302502678560004lfIzQNO",
  "status": "SUCCESS",
  "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/021.mp4"
}

失败

json
{
  "task_id": "task_xxxxxxxxxxxxxxxxxx",
  "request_id": "2026060302502678560004lfIzQNO",
  "status": "FAILURE",
  "fail_reason": "task failed"
}

错误码 ​

HTTP 状态码说明
400请求参数有误，例如 video_url 为空或格式不正确
401API Key 无效或未传入
502视频处理失败，可调整视频 URL 后重新提交

API Reference ​