Quick Start

WAND는 MPS와 VOD 두 개의 독립 API 경로를 제공합니다. 엔드포인트, 액션 이름, 파라미터 구조, 태스크 상태가 전부 다르므로, 사용할 경로를 먼저 정한 뒤 해당 섹션을 따라가세요.

경로 선택

계정 및 인증

두 경로 모두 Tencent Cloud International 계정의 SecretId / SecretKey로 TC3-HMAC-SHA256 서명을 사용합니다. VOD의 텍스트 LLM만 별도로 CreateAigcApiToken으로 발급한 Bearer Token을 사용합니다.

SecretId와 SecretKey는 국제 콘솔의 CAM > API Keys에서 발급합니다. 서명은 API Explorer, tccli, Tencent Cloud SDK가 자동 처리합니다.

VOD 경로

이미지, 영상, 오디오, 3D는 vod.intl.tencentcloudapi.com을 쓰고, 텍스트 LLM은 mmu.vod-qcloud.com 게이트웨이를 사용합니다. 조회는 DescribeTaskDetail 하나로 통합되어 있습니다.

이미지, 영상, 오디오, 3D

curl -X POST https://vod.intl.tencentcloudapi.com \
  -H "X-TC-Action: CreateAigcImageTask" \
  -H "Content-Type: application/json" \
  -H "X-TC-Version: 2018-07-17" \
  -H "X-TC-Region: ap-singapore" \
  -H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/vod/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
  -d '{
  "SubAppId": 0,
  "ModelName": "Kling",
  "ModelVersion": "3.0",
  "Prompt": "a cat on the beach"
}'

태스크 상태는 WAITING → PROCESSING → FINISH입니다. 성공 판정은 Status=FINISH 그리고 ErrCode=0 두 조건을 함께 확인해야 합니다. StorageMode는 Temporary(7일) / Permanent(VOD 미디어 자산 등록) 중 선택합니다.

자세한 내용: VOD Quick Start

텍스트 LLM

텍스트 LLM은 토큰을 먼저 발급한 뒤 게이트웨이로 호출합니다.

1. CreateAigcApiToken에 SubAppId를 전달해 토큰 발급 (ApiToken 반환)
2. 게이트웨이 엔드포인트 선택
3. Authorization: Bearer <토큰> 헤더로 호출

curl -X POST https://mmu.vod-qcloud.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_TOKEN" \
  -d '{
  "model": "gpt-5.1",
  "messages": [
    {
      "role": "user",
      "content": "Hi, who are you?"
    }
  ]
}'

토큰 발급 API는 vod.intl.tencentcloudapi.com에 TC3 서명으로 호출합니다. 토큰 유효 기간은 무기한이며 계정당 최대 50개입니다. VOD Text에서 모델과 파라미터를 확인하세요.

MPS 경로

하나의 엔드포인트에 X-TC-Action으로 동작을 구분합니다. 생성 요청은 TaskId를 반환하고, 전용 조회 액션으로 폴링합니다.

curl -X POST https://mps.intl.tencentcloudapi.com \
  -H "X-TC-Action: CreateAigcImageTask" \
  -H "Content-Type: application/json" \
  -H "X-TC-Version: 2019-06-12" \
  -H "X-TC-Region: ap-singapore" \
  -H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
  -d '{
  "ModelName": "Kling",
  "ModelVersion": "3.0",
  "Prompt": "a cat on the beach",
  "Operator": "admin"
}'

태스크 상태는 WAIT → RUN → DONE / FAIL입니다. 결과 URL은 12시간만 유효하며, 영구 저장은 StoreCosParam을 사용합니다.

자세한 내용: MPS Quick Start

태스크 조회

AIGC 생성 태스크는 생성 후 폴링으로 상태와 결과를 조회합니다. 권장 폴링 간격은 3초입니다.

완료 확인 즉시 결과 URL을 다운로드하거나 자체 스토리지로 옮기세요. MPS의 트랜스코딩, 이미지 처리 등 비 AIGC 태스크는 DescribeTaskDetail / DescribeImageTaskDetail로 조회합니다.

사용량 조회

두 액션 모두 최대 90일 범위를 조회합니다. VOD의 DescribeAigcUsageData는 VOD 전용이며 MPS는 별도 DescribeUsageData를 사용합니다.