Quick Start
WAND提供 MPS 和 VOD 两条独立的 API 路径。两者的 Endpoint、Action 名称、参数结构、任务状态各不相同,请先确定要使用的路径,再按对应章节操作。
路径选择
| 对比项 | MPS 路径 | VOD 路径 |
|---|---|---|
| Endpoint | mps.intl.tencentcloudapi.com | vod.intl.tencentcloudapi.com |
| API 版本 | 2019-06-12 | 2018-07-17 |
| 生成 Action | CreateAigcImageTask / CreateAigcVideoTask / CreateAigcAudioTask | 相同 |
| 查询 Action | DescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTask | 统一为 DescribeTaskDetail 一个 |
| 任务状态 | WAIT / RUN / DONE / FAIL | WAITING / PROCESSING / FINISH + ErrCode |
| 结果有效期 | 12 小时 | Temporary 7 天 / Permanent 永久 |
| 参数结构 | 顶层字段 (ExtraParameters, Operator) | 嵌套字段 (FileInfos.N, OutputConfig, ExtInfo) |
| 文本 LLM | — | 支持 |
| 推荐场景 | 需要与转码、增强等 MPS 功能一起使用时 | 需要作为 VOD 媒体资产永久保存时 |
账号与认证
两条路径均使用 Tencent Cloud International 账号的 SecretId / SecretKey 进行 TC3-HMAC-SHA256 签名。只有 VOD 的文本 LLM 单独使用由 CreateAigcApiToken 签发的 Bearer Token。
| 对象 | 认证 |
|---|---|
| MPS 全部 | 基于 SecretId / SecretKey 的 TC3 签名 |
| VOD 图片、视频、音频、3D | 基于 SecretId / SecretKey 的 TC3 签名 |
| VOD 文本 LLM | 由 CreateAigcApiToken 签发的 Bearer Token |
SecretId 和 SecretKey 在国际控制台 的 CAM > API Keys 中签发。签名由 API Explorer、tccli、Tencent Cloud SDK 自动处理。
SecretId/SecretKey 是拥有账号全部权限的长期凭据。请勿将其写入源代码或公开仓库。
两条路径均仅支持国际站点的海外地域(ap-singapore、ap-seoul、ap-tokyo 等)。
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 需先签发令牌,再通过网关调用。
- 向
CreateAigcApiToken传入SubAppId签发令牌(返回ApiToken) - 选择网关 Endpoint
- 使用
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?"
}
]
}'| 协议 | 路径 | 主要模型 |
|---|---|---|
| OpenAI Completions | /v1/chat/completions | GPT, Gemini, Kimi, GK, GLM, DeepSeek |
| OpenAI Responses | /v1/responses | GPT |
| Messages | /v1/messages | MiniMax, DeepSeek |
签发令牌的 API 需以 TC3 签名方式调用 vod.intl.tencentcloudapi.com。令牌有效期为无限期,每个账号最多 50 个。请在 VOD Text 中查看模型与参数。
MPS 路径
在同一个 Endpoint 上通过 X-TC-Action 区分操作。生成请求返回 TaskId,再通过专用查询 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"
}'任务状态为 WAIT → RUN → DONE / FAIL。结果 URL 仅在 12 小时 内有效,永久保存请使用 StoreCosParam。
详细说明:MPS Quick Start
任务查询
AIGC 生成任务在生成后通过轮询查询状态与结果。建议轮询间隔为 3 秒。
| 路径 | 查询 Action | 状态值 |
|---|---|---|
| MPS | DescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTask | WAIT / RUN / DONE / FAIL |
| VOD | DescribeTaskDetail | WAITING / PROCESSING / FINISH + ErrCode |
确认完成后请立即下载结果 URL 或转存到自有存储。MPS 的转码、图片处理等非 AIGC 任务通过 DescribeTaskDetail / DescribeImageTaskDetail 查询。
用量查询
| 路径 | Action | Endpoint | 统计维度 |
|---|---|---|---|
| MPS | DescribeUsageData | mps.intl.tencentcloudapi.com | 任务类型(Transcode、Enhance、AIGC 等) |
| VOD | DescribeAigcUsageData | vod.intl.tencentcloudapi.com | AIGC 类型(Text、Image、Video、Audio) |
两个 Action 最多查询 90 天 范围内的数据。VOD 的 DescribeAigcUsageData 为 VOD 专用,MPS 使用单独的 DescribeUsageData。