Erase Subtitle · 字幕擦除:
MediaKitEraseVideoSubtitle uses MediaKit’s standard video AI service to detect and erase hard subtitles: text embedded in the video image rather than stored as a separate subtitle track. It is intended for footage where you want to remove visible subtitles before continuing an editing or generation workflow. The node submits the video for processing, waits for the task to finish, and retrieves the processed video. The supplied source does not specify which video formats the service accepts, how it fills the erased area, or whether every subtitle will be removed cleanly, so review the result before using it in a final project.
Erase Subtitle · 字幕擦除 Input Parameters:
video
The required VIDEO input is the footage whose hard subtitles you want to erase. Connect a video from an earlier node; this node prepares it for MediaKit processing. Because the operation targets subtitles visible in the image, choose footage where the text you want removed is actually part of the picture. No default, minimum, or maximum video length or size is specified in the provided node source.
poll_interval_seconds
This required integer controls how many seconds the node waits between checks for the remote processing task’s status. Its default is 10, its minimum is 2, and its maximum is 60. A shorter interval checks for completion more often and may let the node notice a finished task sooner; a longer interval checks less often but may delay that notice. This is an advanced setting and does not specify how MediaKit detects or erases subtitles.
max_poll_attempts
This required integer sets the maximum number of status checks while the node waits for the remote task. Its default is 720, its minimum is 1, and its maximum is 5000. Raising it allows more checks for a task that takes a long time; lowering it limits how long the node keeps checking. Together with poll_interval_seconds, it affects the approximate polling window, but it is not a guaranteed total processing-time limit because submission, processing, and download can also take time. This is an advanced setting and does not change the subtitle-erasure method.
Erase Subtitle · 字幕擦除 Output Parameters:
video
The sole VIDEO output is the processed video downloaded from the result returned by the subtitle-erasure task. Connect it to a preview, save, or subsequent video-processing node to inspect or use the result. It represents the service’s returned video, not a report identifying which subtitles were detected or how completely they were removed.
Erase Subtitle · 字幕擦除 Usage Tips:
- Start with the default polling settings of
10seconds and720attempts. Change them only when you have a reason to check more or less frequently or to allow more checks. - For a task that regularly takes longer than your current polling window, increase
max_poll_attempts. For example,120attempts at10seconds between checks allows approximately 20 minutes of polling intervals, excluding other processing and download time. - If prompt notification matters, reduce
poll_interval_secondstoward its2-second minimum. This changes check frequency, not the speed of the remote erasure task. - Preview the returned video, especially frames with text over detailed or moving backgrounds. The provided source does not guarantee a particular visual result.
- Use this standard-version node for hard subtitles. The source explicitly calls the erasure task with
professional=False; this node does not expose a professional-mode switch.
Erase Subtitle · 字幕擦除 Common Errors and Solutions:
Invalid or missing video input
- Explanation: This is a possible validation or execution failure when no
VIDEOvalue reaches the required input, or when the supplied value cannot be prepared as a video. The provided source does not specify an exact error message. - Solution: Connect a node that produces a
VIDEOoutput and confirm that its video can be opened or previewed before running subtitle erasure.
poll_interval_seconds is outside the allowed range
- Explanation: The node declares an integer range of
2to60seconds. A value outside that range may be rejected by the interface or validation; the exact message is not shown in the supplied source. - Solution: Enter a whole number from
2through60, or restore the default of10.
max_poll_attempts is outside the allowed range
- Explanation: The node declares an integer range of
1to5000attempts. A value outside that range may be rejected by the interface or validation; the exact message is not shown in the supplied source. - Solution: Enter a whole number from
1through5000, or restore the default of720.
Subtitle-erasure task fails or does not finish within the polling limit
- Explanation: The node waits for MediaKit through an imported task function. Its implementation and error strings are not provided, so a task failure or polling-limit message cannot be quoted reliably.
- Solution: Retry the task. If it consistently needs more checks, raise
max_poll_attemptswithin its allowed range; if it fails promptly, check the error shown by your workflow rather than increasing the limit indiscriminately.
Processed video cannot be downloaded
- Explanation: After processing, the node downloads the video from the returned result URL. If that retrieval fails, the node may be unable to provide its
videooutput. The supplied source does not specify the message or cause. - Solution: Retry the workflow and check that the processing service and your connection are available. If the problem persists, keep the displayed error details for troubleshooting.
Subtitles remain visible or the erased area looks imperfect
- Explanation: This is a possible result-quality issue, not a confirmed error message. The source establishes that the node requests hard-subtitle detection and erasure, but does not guarantee complete removal or describe its visual reconstruction method.
- Solution: Review the affected frames and try a different source clip or editing approach where the result is unsuitable. Changing the polling settings will not change the documented erasure method.
