Skip to content

Quick Start โ€‹

Updated

WAND provides two independent API paths: MPS and VOD. The endpoint, action names, parameter structure, and task status are all different, so decide which path to use first and then follow the corresponding section.

Choosing a Path โ€‹

CriteriaMPS pathVOD path
Endpointmps.intl.tencentcloudapi.comvod.intl.tencentcloudapi.com
API version2019-06-122018-07-17
Generation actionCreateAigcImageTask / CreateAigcVideoTask / CreateAigcAudioTaskSame
Query actionDescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTaskConsolidated into a single DescribeTaskDetail
Task statusWAIT / RUN / DONE / FAILWAITING / PROCESSING / FINISH + ErrCode
Result validity period12 hoursTemporary 7 days / Permanent permanent
Parameter structureTop-level fields (ExtraParameters, Operator)Nested fields (FileInfos.N, OutputConfig, ExtInfo)
Text LLMโ€”Supported
Recommended forWhen used together with MPS features such as transcoding and enhancementWhen permanently storing as a VOD media asset

Account and Authentication โ€‹

Both paths use TC3-HMAC-SHA256 signing with the SecretId / SecretKey of a Tencent Cloud International account. Only the text LLM of VOD separately uses a Bearer Token issued by CreateAigcApiToken.

TargetAuthentication
All MPSTC3 signature based on SecretId / SecretKey
VOD image, video, audio, 3DTC3 signature based on SecretId / SecretKey
VOD text LLMBearer Token issued by CreateAigcApiToken

SecretId and SecretKey are issued in International Console under CAM > API Keys. Signing is handled automatically by API Explorer, tccli, and Tencent Cloud SDK.

SecretId/SecretKey are long-term credentials with full account permissions. Do not include them in source code or public repositories.

Both paths can only use overseas regions (ap-singapore, ap-seoul, ap-tokyo, etc.) based on the international site.

VOD Path โ€‹

Image, video, audio, and 3D use vod.intl.tencentcloudapi.com, while the text LLM uses the mmu.vod-qcloud.com gateway. Queries are consolidated into a single DescribeTaskDetail.

Image, Video, Audio, 3D โ€‹

bash
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"
}'

Task status is WAITING โ†’ PROCESSING โ†’ FINISH. To determine success, you must check both conditions together: Status=FINISH and ErrCode=0. For StorageMode, choose between Temporary (7 days) / Permanent (registering a VOD media asset).

For details: VOD Quick Start

Text LLM โ€‹

For the text LLM, issue a token first and then call the gateway.

  1. Issue a token by passing SubAppId to CreateAigcApiToken (returns ApiToken)
  2. Select a gateway endpoint
  3. Call with the Authorization: Bearer <token> header
bash
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?"
    }
  ]
}'
ProtocolPathMain models
OpenAI Completions/v1/chat/completionsGPT, Gemini, Kimi, GK, GLM, DeepSeek
OpenAI Responses/v1/responsesGPT
Messages/v1/messagesMiniMax, DeepSeek

The token issuance API is called on vod.intl.tencentcloudapi.com with a TC3 signature. The token is valid indefinitely, with a maximum of 50 per account. Check the models and parameters in VOD Text.

MPS Path โ€‹

A single endpoint distinguishes operations by X-TC-Action. A generation request returns TaskId, and you poll using the dedicated query action.

bash
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"
}'

Task status is WAIT โ†’ RUN โ†’ DONE / FAIL. The result URL is valid only for 12 hours; use StoreCosParam for permanent storage.

For details: MPS Quick Start

Querying Tasks โ€‹

AIGC generation tasks are queried by polling for status and results after generation. The recommended polling interval is 3 seconds.

PathQuery actionStatus values
MPSDescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTaskWAIT / RUN / DONE / FAIL
VODDescribeTaskDetailWAITING / PROCESSING / FINISH + ErrCode

As soon as completion is confirmed, download the result URL or move it to your own storage. Non-AIGC tasks of MPS, such as transcoding and image processing, are queried with DescribeTaskDetail / DescribeImageTaskDetail.

Querying Usage โ€‹

PathActionEndpointCriteria
MPSDescribeUsageDatamps.intl.tencentcloudapi.comTask type (Transcode, Enhance, AIGC, etc.)
VODDescribeAigcUsageDatavod.intl.tencentcloudapi.comAIGC type (Text, Image, Video, Audio)

Both actions query a range of up to 90 days. The DescribeAigcUsageData of VOD is exclusive to VOD, and MPS uses a separate DescribeUsageData.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages