跳到内容

Quick Start ​

更新时间

WAND提供 MPS 和 VOD 两条独立的 API 路径。两者的 Endpoint、Action 名称、参数结构、任务状态各不相同,请先确定要使用的路径,再按对应章节操作。

路径选择 ​

对比项MPS 路径VOD 路径
Endpointmps.intl.tencentcloudapi.comvod.intl.tencentcloudapi.com
API 版本2019-06-122018-07-17
生成 ActionCreateAigcImageTask / CreateAigcVideoTask / CreateAigcAudioTask相同
查询 ActionDescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTask统一为 DescribeTaskDetail 一个
任务状态WAIT / RUN / DONE / FAILWAITING / 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 ​

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

任务状态为 WAITING → PROCESSING → FINISH。判定成功需同时确认 Status=FINISH 和 ErrCode=0 两个条件。StorageMode 在 Temporary(7 天)/ Permanent(注册 VOD 媒体资产)中任选其一。

详细说明:VOD Quick Start

文本 LLM ​

文本 LLM 需先签发令牌,再通过网关调用。

  1. 向 CreateAigcApiToken 传入 SubAppId 签发令牌(返回 ApiToken)
  2. 选择网关 Endpoint
  3. 使用 Authorization: Bearer <令牌> 请求头调用
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?"
    }
  ]
}'
协议路径主要模型
OpenAI Completions/v1/chat/completionsGPT, Gemini, Kimi, GK, GLM, DeepSeek
OpenAI Responses/v1/responsesGPT
Messages/v1/messagesMiniMax, DeepSeek

签发令牌的 API 需以 TC3 签名方式调用 vod.intl.tencentcloudapi.com。令牌有效期为无限期,每个账号最多 50 个。请在 VOD Text 中查看模型与参数。

MPS 路径 ​

在同一个 Endpoint 上通过 X-TC-Action 区分操作。生成请求返回 TaskId,再通过专用查询 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"
}'

任务状态为 WAIT → RUN → DONE / FAIL。结果 URL 仅在 12 小时 内有效,永久保存请使用 StoreCosParam。

详细说明:MPS Quick Start

任务查询 ​

AIGC 生成任务在生成后通过轮询查询状态与结果。建议轮询间隔为 3 秒。

路径查询 Action状态值
MPSDescribeAigcImageTask / DescribeAigcVideoTask / DescribeAigcAudioTaskWAIT / RUN / DONE / FAIL
VODDescribeTaskDetailWAITING / PROCESSING / FINISH + ErrCode

确认完成后请立即下载结果 URL 或转存到自有存储。MPS 的转码、图片处理等非 AIGC 任务通过 DescribeTaskDetail / DescribeImageTaskDetail 查询。

用量查询 ​

路径ActionEndpoint统计维度
MPSDescribeUsageDatamps.intl.tencentcloudapi.com任务类型(Transcode、Enhance、AIGC 等)
VODDescribeAigcUsageDatavod.intl.tencentcloudapi.comAIGC 类型(Text、Image、Video、Audio)

两个 Action 最多查询 90 天 范围内的数据。VOD 的 DescribeAigcUsageData 为 VOD 专用,MPS 使用单独的 DescribeUsageData。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages