MaiopcMaiopc
Maiopc

视频去字幕 - 创建任务

创建视频去字幕任务,传入视频地址,服务端自动解析时长

POST/kyyReactApiServer/v1/removeSubtitle/videos

视频去字幕创建任务

创建视频去字幕任务。接口接收视频地址,异步检测并擦除视频中的字幕,任务完成后可通过查询接口获取结果视频地址。
客户端需要传入 modelvideoUrl。编码模式等处理参数由服务端根据当前接口绑定的内部配置获取,不作为对外请求参数。

认证

所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

modelbodystring必填
模型名称,当前仅支持 sd2ManxueRemoveSubtitle
videoUrlbodystring必填
待去字幕的视频地址。
支持公网 HTTP/HTTPS URL。

响应参数

idstring
视频去字幕任务的唯一标识符,用于后续查询任务状态。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
statusstring
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
errorstring
错误信息,当 status 为 failed 时返回。

注意事项

重要提示:
  • 需要传入 modelvideoUrl
  • model 当前仅支持 sd2ManxueRemoveSubtitle
  • 支持格式包括 mp4flvtsavimovwmvmkv 等主流视频格式
  • 字幕检测 OCR 主要针对中文和英文优化,其他语言字幕可能无法准确识别,影响擦除效果
  • 画面中的场景文本可能被误识别为字幕并被擦除;例如条幅、标牌等文字如果位置、大小、颜色接近字幕特征,可能被纳入擦除范围
  • 输入分辨率最高支持 2K
  • 输出视频分辨率与输入视频基本保持一致;输入视频分辨率大于 1080p 时,默认按 1080p 输出
  • 服务端自动解析视频时长,不需要额外传 duration
  • 任务处理时长与视频原始时长相关,视频越长处理时间越久