WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

UtilitiesLast Updated 2026-09-30

Document to Video

On this page

PDF, PPTX, DOCX, PNG, JPG 문서를 입력하면 낭독이 포함된 영상을 자동 생성합니다. 튜토리얼 영상, 제품 소개, 콘텐츠 요약에 적합합니다.

API 정보

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

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

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

CreateDocToVideoTask

파라미터 타입 필수 예시 설명
Input.FileUrl Array of String 필수 ["https://example.com/a.pdf","https://example.com/b.pptx"] 문서 URL 목록. 최대 3개. pdf/pptx/docx/png/jpg 지원, 파일당 10MB 이하, 100페이지 이하
Input.Prompt String 필수 이 문서 기반으로 튜토리얼 영상을 생성해 주세요 생성할 영상 설명 프롬프트. 최대 2000자
Input.ModelName String 선택 Wand 문서-영상 모델 이름. 기본 Wand
Input.ModelVersion String 선택 1.0 모델 버전. 기본 1.0
Input.Ratio String 선택 9:16 출력 화면 비율. 16:9(기본) / 9:16 / 1:1
Input.Language String 선택 en 출력 언어. zh(기본) / en / ja / ko / ru / fr / es / de
Input.ReferenceDuration Integer 선택 60 생성 영상의 목표 길이(초). 15~1200 범위이며 실제 길이는 생성 결과에 따라 결정
Input.EnableTTS Boolean 선택 true AI 더빙 활성화
Input.VoiceId String 선택 v1_shUQBcs3N6VrPd9RMTf50H7M5kxeZ1VHIiWGDzq5Q9pE0HoEQ959hpulWHGFZSp3v4w= AI 더빙 음성 ID. EnableTTS 시에만 유효. 생략 시 플랫폼 기본 음성
CosInfo.CosBucketName String 선택 mybucket-125xxx 결과 저장 COS Bucket. 미설정 시 MPS 임시 저장소 사용
CosInfo.CosBucketRegion String 선택 ap-guangzhou 결과 저장 COS Region
CosInfo.CosBucketPath String 선택 /output/doc-to-video/ 결과 저장 COS 경로 접두사

DescribeAigcTaskStatus

파라미터 타입 필수 예시 설명
TaskId String 필수 e084efaa-d25a-xxxx-xxxx-6b85e473c0e5 조회할 태스크 ID

CreateDocToVideoTask

파라미터 타입 필수 예시 설명
TaskId String 항상 e084efaa-d25a-xxxx-xxxx-6b85e473c0e5 발급된 태스크 ID
RequestId String 항상 3c140219-cfe9-470e-b241-907877d6fb03 요청 식별자

DescribeAigcTaskStatus

파라미터 타입 필수 예시 설명
TaskId String 항상 e084efaa-d25a-xxxx-xxxx-6b85e473c0e5 태스크 ID
TaskType String 항상 DocToVideo 태스크 유형
TaskStatus String 항상 FINISHED 태스크 상태. PENDING / PROCESSING / FINISHED / FAILED
OutputUrl String 완료 시 https://... 완료된 결과 영상의 URL
CreateTime String 항상 2026-03-18T15:22:30+08:00 태스크 생성 시각
ScheduledTime String 조건부 2026-03-18T15:22:35+08:00 처리 시작 시각
FinishedTime String 완료 시 2026-03-18T15:30:02+08:00 처리 완료 시각
TaskResultCode Integer 완료 시 0 결과 코드
TaskResultMsg String 완료 시 success 결과 메시지
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))

# 문서 2개를 합쳐 제품 소개 영상 생성 (세로 9:16, 영어, 약 60초, COS 저장)
params = {
    "Input": {
        "FileUrl": [
            "https://example.com/a.pdf",
            "https://example.com/b.pptx"
        ],
        "Prompt": "Combine these two documents into a product introduction video",
        "ModelName": "Wand",
        "ModelVersion": "1.0",
        "Ratio": "9:16",
        "Language": "en",
        "ReferenceDuration": 60
    },
    "CosInfo": {
        "CosBucketName": "mybucket-125xxx",
        "CosBucketRegion": "ap-guangzhou",
        "CosBucketPath": "/output/doc-to-video/"
    }
}

req = models.CreateDocToVideoTaskRequest()
req.from_json_string(json.dumps(params))
resp = client.CreateDocToVideoTask(req)
print(resp.to_json_string())
LANGUAGE
# 태스크 결과 조회
req = models.DescribeAigcTaskStatusRequest()
req.TaskId = "e084efaa-d25a-xxxx-xxxx-6b85e473c0e5"
resp = client.DescribeAigcTaskStatus(req)
print(resp.to_json_string())

응답 예시

LANGUAGE
{
  "TaskId": "e084efaa-d25a-xxxx-xxxx-6b85e473c0e5",
  "TaskType": "DocToVideo",
  "TaskStatus": "FINISHED",
  "OutputUrl": "https://mybucket-125xxx.cos.ap-guangzhou.myqcloud.com/output/doc-to-video/result.mp4",
  "CreateTime": "2026-03-18T15:22:30+08:00",
  "ScheduledTime": "2026-03-18T15:22:35+08:00",
  "FinishedTime": "2026-03-18T15:30:02+08:00",
  "TaskResultCode": 0,
  "TaskResultMsg": "success",
  "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}

사용 안내

문서는 최대 3개, 파일당 10MB·100페이지 이내로 준비합니다. Ratio는 16:9 / 9:16 / 1:1, ReferenceDuration은 15~1200초로 지정하고 Prompt에 지시문을 입력합니다.

영구 보관은 CosInfo에 자체 COS Bucket을 지정합니다. 기본 임시 저장 결과는 생성 후 다운로드합니다.

ReferenceDuration은 목표 길이입니다. TTS 음성은 Dubbing의 clone 모드로 VoiceId를 발급받아 지정하고, 결과는 DescribeAigcTaskStatus로 조회합니다.