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

一、概述

这篇说说如何通过 TokenHub 调用 PixVerse 的三款模型：pixverse-video-v5.6、pixverse-video-v6.0、pixverse-video-c1。

二、前提条件

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

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

·在 控制台-在线推理-视觉模型 处开启对应模型的后付费。

注意：说明：

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

三、调用流程

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

1. 提交任务：调用能力接口（文生/图生/首尾帧/参考生），成功返回 Resp.video_id（任务 ID）。

2. 轮询结果：携带 video_id 调用 查询任务结果 接口，建议每 3~5 秒轮询一次，直至 Resp.status = 1（生成成功），从 Resp.url 获取结果视频。

注意：说明：

四、模型列表

注意：说明：

注意：「画面宽高比」列为文生视频、参考生视频支持的取值范围；图生视频、首尾帧生视频的输出画幅默认跟随输入图片比例。

六、1. 接口描述

仅凭文本提示词生成视频，支持运镜、音频与多镜头开关。

接口：POST https://tokenhub.tencentmaas.com/v1/wand/pixverse/text-to-video

七、2. 输入参数

八、3. 请求示例

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/pixverse/text-to-video' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "pixverse-video-v5.6", "prompt": "一只橙色小猫在窗台上看向镜头", "duration": 5, "quality": "360p", "aspect_ratio": "16:9"}'

注意：说明：

注意：将示例中的 model 替换为 pixverse-video-v5.6 或 pixverse-video-c1，即可调用对应模型。

九、4. 输出参数

十、5. 响应示例

{ "ErrCode": 0, "ErrMsg": "Success", "Resp": { "video_id": "4-WandVideo-4ba31a7d508249b787fa0b0c62a6a399" }, "request_id": "4d384c85-2177-4bae-adf9-364ed917509b" }

十一、6. 错误码

请求失败时 ErrCode 不为 0，具体原因见 ErrMsg。任务提交成功后，生成阶段的任务状态通过 查询任务结果 接口获取：

十三、1. 接口描述

以一张图片为首帧生成动态视频，图片直接传入公网可访问的 URL，输出视频画幅跟随输入图片比例。支持负向提示词、运镜、音频与多镜头开关。

接口：POST https://tokenhub.tencentmaas.com/v1/wand/pixverse/image-to-video

十四、2. 输入参数

十五、3. 请求示例

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/pixverse/image-to-video' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "pixverse-video-v6.0", "prompt": "让图片中的主体自然转头", "img_id": "https://example.com/input.jpg", "duration": 5, "quality": "360p"}'

注意：说明：

注意：将示例中的 model 替换为 pixverse-video-v5.6 或 pixverse-video-c1，即可调用对应模型。

十六、4. 输出参数

十七、5. 响应示例

{ "ErrCode": 0, "ErrMsg": "success", "Resp": { "video_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d" }, "request_id": "4d384c85-2177-4bae-adf9-364ed917509b"}

十八、6. 错误码

请求失败时 ErrCode 不为 0，具体原因见 ErrMsg。任务提交成功后，生成阶段的任务状态通过 查询任务结果 接口获取：

20、1. 接口描述

给定首帧与尾帧两张图片（公网可访问的 URL），生成在两者之间平滑过渡的视频。输出视频画幅跟随输入图片比例。

接口： POST https://tokenhub.tencentmaas.com/v1/wand/pixverse/start-end-to-video

注意：说明：

注意：建议首帧与尾帧图片保持相同的宽高比例，以获得最佳过渡效果。

21、2. 输入参数

22、3. 请求示例

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/pixverse/start-end-to-video' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "pixverse-video-v6.0", "prompt": "从首帧自然过渡到尾帧", "first_frame_img": "https://example.com/start.jpg", "last_frame_img": "https://example.com/end.jpg", "duration": 5, "quality": "360p"}'

注意：说明：

注意：将示例中的 model 替换为 pixverse-video-v5.6 或 pixverse-video-c1，即可调用对应模型。

23、4. 输出参数

24、5. 响应示例

{ "ErrCode": 0, "ErrMsg": "success", "Resp": { "video_id": "1374200019-WandVideo-a786becfdc80433b8cff4aa344c8fd3d" }, "request_id": "4d384c85-2177-4bae-adf9-364ed917509b"}

25、6. 错误码

请求失败时 ErrCode 不为 0，具体原因见 ErrMsg。任务提交成功后，生成阶段的任务状态通过 查询任务结果 接口获取：

27、1. 接口描述

通过一组参考图（主体/背景）结合提示词生成主体一致的视频，参考图直接传入公网可访问的 URL，prompt 中可用 @ref_name 指代具体参考图。

接口：POST https://tokenhub.tencentmaas.com/v1/wand/pixverse/reference-to-video

28、2. 输入参数

image_references 数组元素子字段：

29、3. 请求示例

curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/pixverse/reference-to-video' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "pixverse-video-v6.0", "prompt": "参考图主体自然挥手", "image_references": [ { "img_id": "https://example.com/input.png", "type": "subject" } ], "duration": 5, "quality": "360p", "aspect_ratio": "16:9"}'

注意：说明：

注意：将示例中的 model 替换为 pixverse-video-v5.6 或 pixverse-video-c1，即可调用对应模型。

30、4. 输出参数

31、5. 响应示例

{ "ErrCode": 0, "ErrMsg": "success", "Resp": { "video_id": "1374200019-WandVideo-a786becfdc80433b8cff4aa344c8fd3d" }, "request_id": "4d384c85-2177-4bae-adf9-364ed917509b"}

32、6. 错误码

请求失败时 ErrCode 不为 0，具体原因见 ErrMsg。任务提交成功后，生成阶段的任务状态通过 查询任务结果 接口获取：

34、1. 接口描述

四个能力接口共用的任务查询接口，用于轮询获取生成结果。

接口：GET https://tokenhub.tencentmaas.com/v1/wand/pixverse/tasks/{task_id}

注意：说明：

注意：路径中的 {task_id} 即提交任务时返回的 Resp.video_id（示例中以 YOUR_TASK_ID 占位）。视频生成约需数分钟，建议每 3~5 秒轮询一次。

35、2. 输入参数

36、3. 请求示例

curl -X GET 'https://tokenhub.tencentmaas.com/v1/wand/pixverse/tasks/YOUR_TASK_ID' \\ -H 'Authorization: Bearer YOUR_API_KEY'

37、4. 输出参数

38、5. 响应示例

生成成功：

{ "ErrCode": 0, "ErrMsg": "Success", "Resp": { "id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d", "status": 1, "url": "https://aigc-video.cos.myqcloud.com/12245233/4-WandVideo-33b8cff4aa344c8fd3d_0.mp4?q-sign=keLrAG", "prompt": "一只橙色小猫在窗台上看向镜头", "negative_prompt": "", "seed": 0, "style": "", "resolution_ratio": 720, "outputWidth": 1280, "outputHeight": 720, "size": 0, "create_time": "2026-07-29 15:41:31", "modify_time": "2026-07-29 15:42:10" }, "tokenhub_usage": { "total_tokens": 102655 }, "request_id": "2524bc44-5c6f-4114-9b94-6c57eb85f54a-query-1785393236"}

39、6. 状态码

40、附录：通用参数限制速查

42、1. 三款模型如何选择？

·通用场景、或需要多镜头智能分镜：pixverse-video-v6.0。

·打斗、法术特效、高速运动等动态场景：pixverse-video-c1。

·pixverse-video-v5.6 为历史版本，新接入建议直接使用 V6.0。

43、2. 为什么 v5.6 在 1080p 下无法生成 10 秒视频？

pixverse-video-v5.6 在 1080p 清晰度下仅支持 5 / 8 秒。如需 10 秒，请降低清晰度至 720p 及以下，或切换至 v6.0 / c1（均支持 1~15 秒）。

44、3. 图生/首尾帧/参考生接口中的图片如何传入？

直接传入公网可访问的图片 URL 即可：img_id（图生）、first_frame_img / last_frame_img（首尾帧）、image_references[].url（参考生）均接收图片 URL 字符串，无需先调用上传接口。

45、4. 生成结果视频链接会过期吗？

建议任务成功后及时下载 Resp.url 中的视频文件，有效期不超过12小时，建议尽快下载使用。