Vidu 视频生成 · 概述

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配 Vidu 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

能力简介

Vidu 视频生成支持以下任务类型，分别通过独立的接口提交：

任务类型	接口路径	说明
文生视频（T2V）	`POST /vidu/ent/v2/text2video`	根据文本提示词生成视频
图生视频（I2V）	`POST /vidu/ent/v2/img2video`	以首帧图片驱动生成视频
参考生视频	`POST /vidu/ent/v2/reference2video`	以参考图片/视频的主体一致性生成视频，支持主体库
首尾帧	`POST /vidu/ent/v2/start-end2video`	指定首帧和尾帧图片生成过渡视频
智能多帧	`POST /vidu/ent/v2/multiframe`	多个关键帧图片生成长视频
场景特效模板	`POST /vidu/ent/v2/template`	基于预设场景模板生成特效视频
模板成片	`POST /vidu/ent/v2/template-story`	基于故事模板一键生成成片

视频生成为异步任务：提交后立即返回 task_id，需通过查询任务接口轮询任务状态；任务成功后响应中包含 creations.url（视频下载地址，有效期 24 小时），请及时下载或转存。

标准调用流程

创建任务 (POST /vidu/ent/v2/{endpoint})
        │  返回 task_id + state: "created"
        ▼
查询状态 (GET /vidu/ent/v2/tasks?task_ids={task_id})   ← 轮询直至 success 或 failed
        │  返回 creations.url（24 小时有效）
        ▼
下载视频文件

接口地址

接口	方法	地址
文生视频	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/text2video`
图生视频	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/img2video`
参考生视频	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/reference2video`
首尾帧	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/start-end2video`
智能多帧	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/multiframe`
场景特效模板	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/template`
模板成片	`POST`	`https://platform.shuyanai.com/vidu/ent/v2/template-story`
查询任务列表	`GET`	`https://platform.shuyanai.com/vidu/ent/v2/tasks`

路径规则：在平台域名后追加渠道前缀 /vidu，再拼接 Vidu 官方原始路径即可。
例如官方 https://api.vidu.cn/ent/v2/text2video → 平台 https://platform.shuyanai.com/vidu/ent/v2/text2video。

鉴权

所有请求均通过 HTTP Authorization 头携带 Bearer Token 进行鉴权：

Authorization: Bearer {API_KEY}

{API_KEY} 为您在平台控制台创建的接口密钥。

注意：Vidu 官方接口使用 Token 前缀鉴权，但本平台统一使用 Bearer 前缀。请勿使用 Token 前缀，否则会返回「无效的令牌」错误。

请求头

头部	必填	说明
`Authorization`	是	`Bearer {API_KEY}`
`Content-Type`	是	固定为 `application/json`

模型概览

模型	文生视频	图生视频	参考生	首尾帧	智能多帧	音视频直出	时长范围	默认分辨率
viduq3-pro	✅	✅	✅	✅	—	✅（默认开启）	1–16s	720p
viduq3-turbo	✅	✅	✅	✅	—	✅（默认开启）	1–16s	720p
viduq3-pro-fast	—	✅	—	—	—	✅（默认开启）	1–16s	720p
viduq3-mix	—	—	✅（仅非主体）	—	—	✅	3–16s	720p
viduq2-pro	—	✅	✅	✅	✅	可选	1–10s	720p
viduq2-pro-fast	—	✅	—	✅	—	可选	1–10s	720p
viduq2-turbo	—	✅	—	✅	✅	可选	1–10s	720p
viduq2	✅	—	✅	—	—	—	1–10s	720p
viduq1	✅	✅	✅	✅	—	—	5s	1080p
viduq1-classic	—	✅	—	✅	—	—	5s	1080p
vidu2.0	—	✅	✅	✅	—	—	4s/8s	360p/720p

不同接口支持的模型列表可能有所差异，请以各接口文档中的说明为准。

任务状态值

状态	含义
`created`	创建成功
`queueing`	排队中
`processing`	处理中
`success`	生成成功
`failed`	生成失败

回调通知

所有创建任务接口均支持 callback_url 参数。设置后，当任务状态变化时，Vidu 将以 POST 方式向该地址发送回调请求，内容结构与查询任务接口的返回体一致。回调状态包括 processing、success、failed，失败时最多重试 3 次。

00-概述

Vidu 视频生成 · 概述

能力简介

标准调用流程

接口地址

鉴权

请求头

模型概览

任务状态值

回调通知

相关文档

00-概述

Vidu 视频生成 · 概述#

能力简介#

标准调用流程#

接口地址#

鉴权#

请求头#

模型概览#

任务状态值#

回调通知#

相关文档#

Vidu 视频生成 · 概述

能力简介

标准调用流程

接口地址

鉴权

请求头

模型概览

任务状态值

回调通知

相关文档