Quick Start

WAND의 미디어 처리 기능은 Tencent Cloud MPS(Media Processing Service) API를 통해 제공됩니다. 이 문서는 Tencent Cloud International 계정 기준으로 첫 호출까지의 절차를 안내합니다.

사전 준비

Tencent Cloud International 계정 (없다면 가입 후 실명 인증 완료)

Cloud API Key 발급

Tencent Cloud International 콘솔에 로그인합니다.
CAM > API Keys 메뉴로 이동합니다.
New Key를 클릭해 SecretId와 SecretKey를 발급받습니다.
발급된 SecretKey는 다시 확인할 수 없으므로 즉시 안전한 위치에 저장합니다.

SecretId/SecretKey는 계정의 모든 API 권한을 가진 장기 자격 증명입니다. 소스 코드나 공개 저장소에 포함하지 마세요.

VOD/MPS 서비스 개통

VOD 콘솔에 접속합니다.
안내에 따라 VOD 서비스를 활성화합니다. MPS 처리 기능은 VOD 콘솔에서 함께 개통됩니다.
미디어 파일 입출력에 사용할 COS 버킷을 준비합니다. 버킷 이름과 버킷 리전을 기록해 둡니다.

환경 변수 설정

API 호출에 필요한 값을 환경 변수로 설정합니다.

# 필수: 계정 자격 증명
export TENCENTCLOUD_SECRET_ID="<발급받은 SecretId>"
export TENCENTCLOUD_SECRET_KEY="<발급받은 SecretKey>"

# 필수: API 호출 리전 (예: ap-singapore)
export TENCENTCLOUD_API_REGION="ap-singapore"

# 필수: COS 버킷 정보
export TENCENTCLOUD_COS_BUCKET="<버킷 이름>"
export TENCENTCLOUD_COS_REGION="ap-singapore"

# International 사이트 권장 엔드포인트
export TENCENTCLOUD_MPS_ENDPOINT="mps.intl.tencentcloudapi.com"

International 사이트(mps.intl.tencentcloudapi.com)에서는 중국 본토 리전(ap-guangzhou, ap-beijing, ap-shanghai, ap-chengdu, ap-chongqing)을 사용할 수 없습니다. ap-singapore, ap-seoul, ap-tokyo, na-siliconvalley 등 해외 리전을 선택하세요.

첫 API 호출

MPS API는 TC3-HMAC-SHA256 서명이 필요합니다. 서명 생성은 API Explorer 또는 Tencent Cloud SDK/CLI(tccli) 사용을 권장합니다.작업 상태 조회(DescribeTaskDetail) 호출 예시입니다.

curl -X POST https://mps.intl.tencentcloudapi.com \
  -H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<signature>" \
  -H "Content-Type: application/json" \
  -H "X-TC-Action: DescribeTaskDetail" \
  -H "X-TC-Version: 2019-06-12" \
  -H "X-TC-Region: ap-singapore" \
  -H "X-TC-Timestamp: <unix timestamp>" \
  -d '{"TaskId": "<조회할 TaskId>"}'

tccli를 사용하면 서명을 자동으로 처리합니다.

tccli mps DescribeTaskDetail \
  --TaskId "<조회할 TaskId>" \
  --region ap-singapore \
  --endpoint mps.intl.tencentcloudapi.com

Getting Started

WAND AIGC

MPS Features

TokenHub

Appendix

사전 준비

다음 단계

Transcoding

TokenHub Quick Start

​사전 준비

​다음 단계

Transcoding

TokenHub Quick Start

사전 준비

다음 단계