Tutorial · Python · ~10 min

Short Drama Subtitle Removal

Short-drama pipelines ship one master and many language tracks. The burned-in subtitles have to go first — here is the clean way.

PythonShort DramaAPI

Why this matters

Vertical short dramas are localized at scale: 20 languages, one episode master. Burned-in Chinese subtitles block dubbing and force re-renders.

The Subtitle Eraser API detects subtitle regions per scene, inpaints the underlying video, and exports a clean master for the localization pipeline.

How it works

Point the API at the episode, let region detection find the text zones, and get back a subtitle-free master — plus a sidecar of detected regions for QC.

Submit a job with an input URL (S3, GCS or HTTPS), poll the job URL, and download the rendered output. No GPU, no queues, no ffmpeg builds to babysit.

Code

Python
import requests, time

API = "https://api.mlslabs.io/v1/subtitle-eraser/jobs"
headers = {"X-API-Key": "YOUR_API_KEY"}
payload = {"input": "s3://bucket/episode.mp4", "regions": "auto", "lang": "zh"}

resp = requests.post(API, json=payload, headers=headers)
job = resp.json()
while job["status"] not in ("succeeded", "failed"):
    time.sleep(3)
    job = requests.get(job["url"], headers=headers).json()

print("Output:", job["output_url"])

Pro tips

  • Clean master once, dub N times — never re-inpaint per language.
  • QC regions on the first episode of each new show before batch processing.
  • Use the detected-regions sidecar to auto-skip already-clean scenes.

Pricing note

Usage is metered per minute of media processed; the first tier is free each month. Volume discounts kick in automatically.

FAQ

Common questions

Will it handle vertical 9:16 episodes?

Yes — region detection is resolution-agnostic and handles vertical framing natively.

Can it distinguish subtitles from burned-in watermarks?

Yes — you can pass keep-zones to preserve logos while erasing dialogue text.

What quality can I expect on complex backgrounds?

The inpainting model reconstructs texture; busy scenes may need the high-quality preset, which costs a little more time.