00-概述
Vidu 视频生成 · 概述
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配 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。
鉴权
Authorization 头携带 Token 密钥进行鉴权：Authorization: Token {API_KEY}{API_KEY} 为您在平台控制台创建的接口密钥。注意：Vidu 使用 Token前缀鉴权，与其他平台的Bearer前缀不同。
请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Token {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 次。相关文档
