ZeroFA API

字幕擦除（异步）

智能擦除已生成视频画面中的硬字幕并保留原始画面，只需提供对应视频任务 id。

POSThttps://zerofa.ai/v1/video/subtitle-erase

功能说明

传入此前生成的视频任务 id，系统会识别并擦除画面下半部的硬字幕，输出无字幕成片。所有 Key 档位均可使用。

只能处理当前账号生成且已成功出片的视频。输入分辨率不超过 2K，输出最高 1080P。

两步式异步流程

  1. 提交：POST /v1/video/subtitle-erase 立即返回 job_id 和 submitted 状态。
  2. 轮询：每隔几秒请求 GET /v1/video/subtitle-erase/{job_id}，直到状态变为 succeeded 或 failed。

提交参数

Body 参数application/json
source_task_idstring必填
源视频任务 id，即调用 POST /v1/videos 时返回的 id。必须属于当前账号且已成功出片。
示例：<视频任务 id>
modelstring可选
可选，仅作为业务标记回显，不影响处理。

查询任务

GET/v1/video/subtitle-erase/{job_id}

返回 submitted、succeeded 或 failed 状态。成功时包含 result_url，失败时包含 error_message。

result_url 为擦除后的成片链接，分辨率与源视频一致且最高为 1080P。链接有时效，请及时下载保存。

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时，点击页面顶部“调试”拉起在线运行面板。

① 提交
curl https://zerofa.ai/v1/video/subtitle-erase \
  -H "Authorization: Bearer sk-zerofa-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "source_task_id": "<视频任务 id>"
  }'
# → {"job_id":"<job-id>","status":"submitted"}
② 轮询
curl https://zerofa.ai/v1/video/subtitle-erase/<job-id> \
  -H "Authorization: Bearer sk-zerofa-xxx"

# 处理中    → {"job_id":"...","status":"submitted"}
# succeeded → {"job_id":"...","status":"succeeded",
#              "result_url":"https://..."}
# failed    → {"job_id":"...","status":"failed",
#              "error_message":"..."}