大模型服务平台 TokenHub WAND 生视频调用指南

二、前提条件

·已 注册腾讯云 账号并开通 TokenHub 服务。

·已在 TokenHub 控制台 获取 API Key。

注意：说明：

注意：下文所有示例中的 YOUR_API_KEY 均需替换为你自己的 API Key，鉴权方式为请求头 Authorization: Bearer YOUR_API_KEY。

三、调用流程

视频生成为耗时任务（通常 1~3 分钟），接口采用异步调用模式，统一分两步：

1. 提交任务：调用 POST /v1/wand/vega-videos/tasks，成功返回 id 与 status=queued。

2. 轮询结果：携带 id 调用 GET /v1/wand/vega-videos/tasks/{id}，直至 status 为 succeeded 或 failed，成功后从 content.video_url 获取视频地址。

四、模型列表

六、1. 接口描述

提交一个视频生成任务。三种生成形态（文生、首尾帧生、参考生）共用本接口，通过 content 数组中元素的 type 与 role 组合区分。

接口：POST https://tokenhub.tencentmaas.com/v1/wand/vega-videos/tasks

七、2. 输入参数

八、options 对象字段

options 用于承载“高级 / 扩展”档位类参数。

九、content 数组元素参数

content 是一个按 type 区分的联合类型数组，各元素字段互斥：

type 与 role 的组合：

十、3. 文生视频请求示例

仅凭文本提示词生成视频。content 数组只包含一个 type=text 元素，resolution、ratio、duration 均可显式指定。

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/vega-videos/tasks' \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -d '{ "model": "wand-vega-video-1.0-lite", "content": [ { "type": "text", "text": "一只橙色小猫在窗台上看向镜头，阳光从侧面洒入，镜头缓缓推进" } ], "resolution": "768P", "ratio": "16:9", "duration": 6}'

十一、4. 首尾帧生视频请求示例

以 1~2 张图片作为首帧 / 尾帧，结合文本提示词生成视频。在 content 中传入 type=image_url 且 role 为 first_frame / last_frame 的元素。

注意：说明：

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/vega-videos/tasks' \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -d '{ "model": "wand-vega-video-1.0-lite", "content": [ { "type": "text", "text": "镜头从首帧自然过渡到尾帧，保持光影连续" }, { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" }, "role": "first_frame" }, { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" }, "role": "last_frame" } ], "resolution": "1080P", "duration": 8}'

十二、5. 参考生视频请求示例

以文本 + 参考图片 / 参考视频 / 参考音频的组合生成视频。在 content 中传入 type=image_url / type=video_url / type=audio_url 元素：

·type=image_url：role 传 reference_image。

·type=video_url：role 固定为 reference_video。

·type=audio_url：role 固定为 reference_audio。

role 对以上三种 type 均为必填，省略或留空会被拒绝。

注意：说明：

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/vega-videos/tasks' \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -d '{ "model": "wand-vega-video-1.0-lite", "content": [ { "type": "text", "text": "参考图中的角色在参考视频的场景里自然运动，背景音乐与画面节奏一致" }, { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" }, "role": "reference_image" }, { "type": "video_url", "video_url": { "url": "https://example.com/scene.mp4" }, "role": "reference_video" }, { "type": "audio_url", "audio_url": { "url": "https://example.com/bgm.mp3" }, "role": "reference_audio" } ], "resolution": "768P", "ratio": "16:9", "duration": 10}'

十三、6. 输出参数

注意：说明：

十四、7. 响应示例

HTTP/1.1 201 CreatedContent-Type: application/json{ "id": "1300000000-video-68b7c1d4a1f2e3d4c5b6a79808192a3b4c5d6e7f8-0000", "model": "wand-vega-video-1.0-lite", "status": "queued"}

十六、1. 接口描述

各生成形态共用的任务查询端点：提交任务返回 id 后，通过本接口轮询任务状态，成功后从 content.video_url 获取视频地址。

接口：GET https://tokenhub.tencentmaas.com/v1/wand/vega-videos/tasks/{id}

十七、2. 输入参数

十八、3. 请求示例

curl -X GET 'https://tokenhub.tencentmaas.com/v1/wand/vega-videos/tasks/<Fid>' \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer YOUR_API_KEY'

十九、4. 输出参数

20、5. 响应示例

{ "id": "1300000000-video-68b7c1d4a1f2e3d4c5b6a79808192a3b4c5d6e7f8-0000", "model": "wand-vega-video-1.0-lite", "status": "succeeded", "content": { "video_url": "https://aigc-video.example.com/xxx/result.mp4" }}

22、统一错误码

24、1. 传入不支持的 resolution 会降级吗？

不会。超出当前模型档位的 resolution 会在提交阶段直接返回 400 invalid_request_error（如 Lite 传 720P）。

25、2. 生成结果视频链接会过期吗？

会过期。生成结果为临时地址，有效期 12 小时，请在任务成功后及时下载并转存到自有存储。

26、3. 提交成功但一直处于 queued 怎么办？

排队超时的任务会被置为 failed 并返回 error.code = TaskTimeout。若长时间停留在 queued，请稍后重试并提交 id 联系技术支持。