Video Remove Subtitle

Overview

Remove subtitles and other text burned into video frames, and reconstruct the background with Qubico/video-toolkit and task_type: remove-subtitle. This edits visible pixels; it does not remove or edit a separate subtitle track.

Automatic: omit input.region or set it to null to detect text throughout the frame. Other visible text may also be removed.

Region: provide one fixed rectangle to remove text only within that area throughout the video. Use this to preserve text elsewhere in the frame.

Pricing

Mode	Price (USD)	Billing unit
Automatic removal	$0.006	Per source-video second, rounded up
Region removal	$0.006	Per source-video second, rounded up

For example, 4 seconds costs $0.024, 4.02 seconds costs $0.030, and 60 seconds costs $0.360. There is no five-second minimum charge. Duration is measured from the source video, not the processed output. Credits are reserved before processing, consumed on success, and released on failure. Each submitted task is billed separately.

Notes

video must be a publicly downloadable HTTP(S) URL on port 80 or 443. Base64, direct file uploads, login-protected links, and links requiring custom request headers are not supported.

Input: one regular MP4 with one video track, 1–600 seconds, at most 60 MiB (62,914,560 bytes). Export fragmented MP4 or videos with rotation metadata as a regular, correctly oriented MP4 first.

region uses original-video pixels, with (0, 0) at the top left. x and y must be nonnegative integers; width and height must be positive integers. The whole rectangle must fit inside the frame. Convert coordinates from a scaled preview back to the original dimensions.

An omitted or null region selects automatic removal. An empty, incomplete, fractional, or out-of-bounds region is rejected; it never switches silently to automatic removal.

Invalid input returns HTTP 400 without consuming credits. Examples include region requires integer x, y, width and height and region exceeds the video dimensions.

input accepts only video and optional region. Duration and dimensions are measured automatically; do not send duration, resolution, prompt, or other processing options.

Only one fixed rectangle is supported. Multiple regions, per-segment regions, and moving masks are not supported.

Output retains video dimensions and audio content, but video and audio may be re-encoded. Complex backgrounds can show fill artifacts; removal quality for moving or full-frame translucent watermarks is not guaranteed.

Cancellation is available only before processing has been submitted. Once submitted, the task cannot be canceled. A processing timeout is reported as a failed task and releases reserved credits.

Request

Header Params

Body Params application/jsonRequired

Examples

Automatic removalRegion removal (1920 x 1080 source)

Replace the placeholder URL with your MP4 URL.

{
  "model": "Qubico/video-toolkit",
  "task_type": "remove-subtitle",
  "input": {
    "video": "https://example.com/input.mp4"
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Task accepted; inspect data.status and poll until completion.

Bodyapplication/json

Examples

Accepted automatic removalAccepted region removal

Illustrative 4-second source video. Task IDs and URLs are placeholders. The region example assumes a 1920 x 1080 source.

{
  "code": 200,
  "data": {
    "task_id": "00000000-0000-4000-8000-000000000001",
    "model": "Qubico/video-toolkit",
    "task_type": "remove-subtitle",
    "status": "pending",
    "config": {
      "service_mode": "",
      "webhook_config": {
        "endpoint": "",
        "secret": ""
      }
    },
    "input": {
      "video": "https://example.com/input.mp4"
    },
    "output": null,
    "meta": {
      "created_at": "2026-10-16T04:00:00Z",
      "started_at": "0001-01-01T00:00:00Z",
      "ended_at": "0001-01-01T00:00:00Z",
      "usage": {
        "type": "point",
        "frozen": 240000,
        "consume": 0
      },
      "is_using_private_pool": false
    },
    "detail": null,
    "logs": [],
    "error": {
      "code": 0,
      "message": "",
      "detail": null
    }
  },
  "message": "success"
}