EraseLast Updated 2026-09-30

Smart Erase

On this page

영상 화면의 시각 요소를 지우거나 가립니다. 자막 제거, 고급 워터마크 제거, 얼굴 모자이크, 얼굴+번호판 모자이크를 프리셋 템플릿으로 제공하며, 자막 제거 템플릿에서는 영역 지정과 OCR 자막 추출, 번역을 함께 수행할 수 있습니다.

API 정보

항목	값
서비스	MPS
API Action	`ProcessMedia`
엔드포인트	`mps.tencentcloudapi.com`
API 버전	`2019-06`-12
처리 방식	비동기 (TaskId 발급 후 결과 조회)

인증은 모든 API가 공통으로 TC3-HMAC-SHA256(SecretId/SecretKey) 서명을 사용합니다. 서명 생성 방법은 Quick Start의 TokenHub 문서를 참고하세요.

결과 조회는 DescribeTaskDetail 또는 완료 콜백으로 받을 수 있습니다.

요청 파라미터

파라미터	타입	필수	예시	설명
InputInfo	Object	필수	`{"Type":"COS","CosInputInfo":{"Bucket":"mybucket-125xxx","Region":"ap-guangzhou","Object":"/input/video.mp4"}}`	입력 미디어 정보. `Type`은 `URL` 또는 `COS`
OutputStorage	Object	선택	`{"Type":"COS","CosOutputStorage":{"Bucket":"mybucket-125xxx","Region":"ap-guangzhou"}}`	출력 저장소. COS Bucket과 Region 지정
OutputDir	String	선택	`/output/erase/`	출력 디렉터리. `/`로 시작하고 `/`로 끝나야 함
SmartEraseTask.Definition	Integer	필수	`101`	지우기 템플릿 ID. 아래 템플릿 표 참조
SmartEraseTask.OverrideParameter	Object	선택	아래 호출 예시 참조	템플릿 파라미터 오버라이드. 자막 제거 템플릿(`101`/`102`)에서만 지원
OverrideParameter.EraseType	String	필수(오버라이드 시)	`subtitle`	지우기 유형. 자막 제거는 `subtitle`
OverrideParameter.EraseSubtitleConfig.AutoAreas.N	Object	선택	`{"LeftTopX":0,"LeftTopY":0,"RightBottomX":1,"RightBottomY":0.25,"Unit":1}`	자동 지우기 영역(`0~1` 비율 좌표). 여러 개 지정 가능
OverrideParameter.EraseSubtitleConfig.CustomAreas.N	Object	선택	-	시간대별 커스텀 영역(BEGIN, END, X1, Y1, X2, Y2)
SmartEraseTask.OutputObjectPath	String	선택	`/output/{inputName}_erase.{format}`	출력 파일 경로
TaskNotifyConfig.NotifyUrl	String	선택	`https://example.com/callback`	태스크 완료 콜백 URL. NotifyType은 `URL`

프리셋 템플릿(Definition)은 용도에 따라 다음 값 중 하나를 반드시 명시합니다.

Definition	용도
`101`	자막 제거(기본)
`102`	자막 제거 + OCR 자막 추출
`201`	고급 워터마크 제거
`301`	얼굴 모자이크
`302`	얼굴 + 번호판 모자이크

자주 쓰는 영역 프리셋 좌표는 다음과 같습니다.

영역	LeftTop (X, Y)	RightBottom (X, Y)
전체 화면	(`0`, `0`)	(`0.9999`, `0.9999`)
상단 절반	(`0`, `0`)	(`0.9999`, `0.5`)
하단 절반	(`0`, `0.5`)	(`0.9999`, `0.9999`)
중앙	(`0.1`, `0.3`)	(`0.9`, `0.7`)
좌측	(`0`, `0`)	(`0.5`, `0.9999`)
우측	(`0.5`, `0`)	(`0.9999`, `0.9999`)

응답 파라미터

파라미터	타입	필수	예시	설명
TaskId	String	항상	`2600011633-WorkflowTask-xxxxx`	발급된 태스크 ID. 결과 조회에 사용
RequestId	String	항상	`3c140219-cfe9-470e-b241-907877d6fb03`	요청 식별자

호출 예시

LANGUAGE
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.mps.v20190612 import mps_client, models

cred = credential.Credential("<SecretId>", "<SecretKey>")
http_profile = HttpProfile()
http_profile.endpoint = "mps.tencentcloudapi.com"
client = mps_client.MpsClient(cred, "ap-guangzhou", ClientProfile(httpProfile=http_profile))

# 자막 제거 (템플릿 101)
params = {
    "InputInfo": {
        "Type": "URL",
        "UrlInputInfo": {"Url": "https://example.com/video.mp4"}
    },
    "OutputStorage": {
        "Type": "COS",
        "CosOutputStorage": {"Bucket": "mybucket-125xxx", "Region": "ap-guangzhou"}
    },
    "OutputDir": "/output/erase/",
    "SmartEraseTask": {"Definition": 101}
}

req = models.ProcessMediaRequest()
req.from_json_string(json.dumps(params))
resp = client.ProcessMedia(req)
print(resp.to_json_string())

LANGUAGE
# 자막 제거 + 영역 오버라이드: 화면 상단 0~25%와 하단 75~100% 두 영역
params["SmartEraseTask"] = {
    "Definition": 101,
    "OverrideParameter": {
        "EraseType": "subtitle",
        "EraseSubtitleConfig": {
            "AutoAreas": [
                {"LeftTopX": 0, "LeftTopY": 0, "RightBottomX": 1, "RightBottomY": 0.25, "Unit": 1},
                {"LeftTopX": 0, "LeftTopY": 0.75, "RightBottomX": 1, "RightBottomY": 1, "Unit": 1}
            ]
        }
    }
}

응답 예시

LANGUAGE
{
  "TaskId": "2600011633-WorkflowTask-xxxxx",
  "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}

사용 안내

자막 제거와 OCR 추출은 Definition=102, 텍스트 지우기는 101을 사용합니다.

OverrideParameter는 자막 제거 템플릿(101/102)에서만 지원됩니다. 워터마크 제거(201), 얼굴 모자이크(301), 얼굴+번호판 모자이크(302)는 템플릿 그대로 사용합니다.

자막 번역은 OCR 추출이 활성화된 경우(템플릿 102)에만 사용할 수 있으며, zh / en / ja / ko / fr / es / it / de / tr / ru / pt / vi / id / ms / th / ar / hi 총 17개 언어를 지원합니다. 추출 자막 포맷은 vtt(기본) 또는 srt입니다.