Quick Start โ
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 โ
| Criteria | MPS path | VOD path |
|---|---|---|
| Endpoint | mps.intl.tencentcloudapi.com | vod.intl.tencentcloudapi.com |
| API version | 2019-06-12 | 2018-07-17 |
| Generation action | CreateAigcImageTask / CreateAigcVideoTask / CreateAigcAudioTask | Same |
| Query action | DescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTask | Consolidated into a single DescribeTaskDetail |
| Task status | WAIT / RUN / DONE / FAIL | WAITING / PROCESSING / FINISH + ErrCode |
| Result validity period | 12 hours | Temporary 7 days / Permanent permanent |
| Parameter structure | Top-level fields (ExtraParameters, Operator) | Nested fields (FileInfos.N, OutputConfig, ExtInfo) |
| Text LLM | โ | Supported |
| Recommended for | When used together with MPS features such as transcoding and enhancement | When 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.
| Target | Authentication |
|---|---|
| All MPS | TC3 signature based on SecretId / SecretKey |
| VOD image, video, audio, 3D | TC3 signature based on SecretId / SecretKey |
| VOD text LLM | Bearer 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 โ
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.
- Issue a token by passing
SubAppIdtoCreateAigcApiToken(returnsApiToken) - Select a gateway endpoint
- Call with the
Authorization: Bearer <token>header
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?"
}
]
}'| Protocol | Path | Main models |
|---|---|---|
| OpenAI Completions | /v1/chat/completions | GPT, Gemini, Kimi, GK, GLM, DeepSeek |
| OpenAI Responses | /v1/responses | GPT |
| Messages | /v1/messages | MiniMax, 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.
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.
| Path | Query action | Status values |
|---|---|---|
| MPS | DescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTask | WAIT / RUN / DONE / FAIL |
| VOD | DescribeTaskDetail | WAITING / 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 โ
| Path | Action | Endpoint | Criteria |
|---|---|---|---|
| MPS | DescribeUsageData | mps.intl.tencentcloudapi.com | Task type (Transcode, Enhance, AIGC, etc.) |
| VOD | DescribeAigcUsageData | vod.intl.tencentcloudapi.com | AIGC 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.