MaiopcMaiopc
wechatwechat
Maiopc

Remove Subtitle - Create Task

Create a video remove-subtitle task by passing a video URL; duration is resolved server-side

POST/kyyReactApiServer/v1/removeSubtitle/videos

Remove Subtitle Create Task

Create a video remove-subtitle task. The API accepts a video URL, detects and removes subtitles asynchronously, and returns the result video URL through the query API.
Clients need to provide model and videoUrl. The encoding mode and other processing settings are resolved by the server from the internal configuration bound to this API and are not exposed as request parameters.

Authentication

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

modelbodystringrequired
Model name. Currently only sd2ManxueRemoveSubtitle is supported.
videoUrlbodystringrequired
Video URL to process.
Supports public HTTP/HTTPS URLs.

Response Parameters

idstring
Unique identifier of the remove-subtitle task, used for subsequent status queries.
objectstring
Object type, always video.
createdinteger
Task creation timestamp.
statusstring
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
errorstring
Error message, returned when status is failed.

Notes

Important:
  • Provide model and videoUrl
  • model currently only supports sd2ManxueRemoveSubtitle
  • Supported formats include mainstream video formats such as mp4, flv, ts, avi, mov, wmv, and mkv
  • Subtitle OCR is mainly optimized for Chinese and English; subtitles in other languages may not be recognized accurately, which can affect removal quality
  • Scene text may be mistakenly detected as subtitles and removed. For example, banners or signs whose position, size, or color looks similar to subtitles may fall into the removal area
  • Input resolution supports up to 2K
  • Output resolution generally follows the input resolution; if the input resolution is higher than 1080p, the output defaults to 1080p
  • Duration is resolved server-side, so duration is not required
  • Processing time is related to the original video duration; longer videos take longer to process