RemixLast Updated 2026-09-30

Narration

On this page

숏드라마 원본 영상을 입력하면 해설 대본 생성, AI 낭독, 자막 제거를 한 번에 수행해 해설이 입혀진 새 영상을 출력합니다. 여러 에피소드를 순서대로 연결해 하나의 해설 영상으로 만들 수 있습니다.

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/drama.mp4"}}`	첫 번째 에피소드 영상. `Type`은 `URL` 또는 `COS`
OutputStorage	Object	선택	`{"Type":"COS","CosOutputStorage":{"Bucket":"mybucket-125xxx","Region":"ap-guangzhou"}}`	출력 저장소. COS Bucket과 Region 지정
OutputDir	String	선택	`/output/narrate/`	출력 디렉터리. `/`로 시작하고 `/`로 끝나야 함
AiAnalysisTask.Definition	Integer	필수	`35`	AI 분석 태스크 템플릿 ID. 고정값 `35`
AiAnalysisTask.ExtendedParameter	String	필수	아래 호출 예시 참조	해설 설정(JSON 문자열). 아래 reel 표 참조
TaskNotifyConfig.NotifyUrl	String	선택	`https://example.com/callback`	태스크 완료 콜백 URL. NotifyType은 `URL`

ExtendedParameter의 reel 객체 필드는 다음과 같습니다.

파라미터	타입	필수	예시	설명
processType	String	필수	`narrate`	처리 유형. 해설 생성은 `narrate` 고정
narrateParam.onlyNarration	Integer	필수	`1`	해설 전용 모드
narrateParam.concatTransition	String	필수	`flashwhite`	장면 전환 효과
narrateParam.concatTransitionDuration	Number	필수	`0.3`	장면 전환 길이(초)
outputLanguage	String	필수	`zh`	해설 출력 언어
eraseParam.eraseOff	Integer	선택	`1`	`1`이면 자막 지우기 비활성화(무자막 원본용). 생략 시 지우기 활성화
ttsParam.engine	String	필수	`auto`	TTS 엔진
outputVideoCount	Integer	선택	`3`	출력 영상 수. 기본 `1`, 최대 `5`

프리셋 장면(scene)과 ExtendedParameter 조합은 다음과 같습니다.

scene	용도	eraseParam
`short-drama`	화면 자막이 있는 숏드라마(기본)	미설정(지우기 활성화)
`short-drama-no-erase`	무자막 숏드라마	`eraseOff: 1`(원본 화면 유지)

응답 파라미터

파라미터	타입	필수	예시	설명
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))

# 자막이 있는 숏드라마 해설 (short-drama, 지우기 활성화)
params = {
    "InputInfo": {
        "Type": "URL",
        "UrlInputInfo": {"Url": "https://example.com/drama.mp4"}
    },
    "OutputStorage": {
        "Type": "COS",
        "CosOutputStorage": {"Bucket": "mybucket-125xxx", "Region": "ap-guangzhou"}
    },
    "OutputDir": "/output/narrate/",
    "AiAnalysisTask": {
        "Definition": 35,
        "ExtendedParameter": json.dumps({
            "reel": {
                "processType": "narrate",
                "narrateParam": {
                    "onlyNarration": 1,
                    "concatTransition": "flashwhite",
                    "concatTransitionDuration": 0.3
                },
                "outputLanguage": "zh",
                "ttsParam": {"engine": "auto"},
                "outputVideoCount": 1
            }
        })
    }
}

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

LANGUAGE
# 무자막 원본 (short-drama-no-erase): eraseParam.eraseOff=1 추가
params["AiAnalysisTask"]["ExtendedParameter"] = json.dumps({
    "reel": {
        "processType": "narrate",
        "narrateParam": {
            "onlyNarration": 1,
            "concatTransition": "flashwhite",
            "concatTransitionDuration": 0.3
        },
        "outputLanguage": "zh",
        "eraseParam": {"eraseOff": 1},
        "ttsParam": {"engine": "auto"},
        "outputVideoCount": 1
    }
})

응답 예시

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

사용 안내

자막 지우기 여부는 원본 영상에 화면 자막이 있는지로 결정합니다. 자막이 있으면 지우기를 활성화하고, 없으면 eraseParam.eraseOff를 1로 설정해 비활성화합니다. 무자막 원본에 지우기를 켜면 화면이 손상될 수 있습니다.

해설 대본은 MPS가 자동 생성합니다. 여러 에피소드는 같은 해상도로 준비하고 재생 순서대로 전달합니다.

outputVideoCount는 기본 1, 최대 5입니다. 결과 영상은 태스크 완료 후 OutputDir에 기록되며 Task Query로 진행 상태를 조회합니다.