Vidu 视频生成 · 概述#
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 | 基于故事模板一键生成成片 |
| 查询任务 | GET /vidu/ent/v2/tasks/{task_id}/creations | 查询单个任务的状态与生成结果 |
智能多帧、场景特效模板、模板成片当前暂未开放，如需使用请联系商务。
task_id，再通过查询任务接口轮询状态；任务成功后从 creations[].url 获取视频地址（有效期 24 小时），请及时下载或转存。调用流程#
创建任务 POST /vidu/ent/v2/{endpoint}
│ 返回 task_id，state 为 created
▼
查询状态 GET /vidu/ent/v2/tasks/{task_id}/creations ← 轮询直至 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/{task_id}/creations |
| 查询任务列表 | GET | https://platform.shuyanai.com/vidu/ent/v2/tasks |
路径规则：在 https://platform.shuyanai.com 后加前缀 /vidu，再拼接 Vidu 官方路径。例如官方 /ent/v2/text2video 对应 https://platform.shuyanai.com/vidu/ent/v2/text2video。鉴权与请求头#
| 头部 | 必填 | 说明 |
|---|
Authorization | 是 | Bearer sk-xxx，sk-xxx 为控制台创建的 API Key |
Content-Type | 是 | 固定为 application/json |
Vidu 官方接口使用 Token 前缀鉴权，本平台统一使用 Bearer 前缀。使用 Token 前缀会返回「无效的令牌」（401）。
模型概览#
| 模型 | 文生视频 | 图生视频 | 参考生 | 首尾帧 | 音视频直出 | 时长范围 | 默认分辨率 |
|---|
viduq3-pro | 支持 | 支持 | — | 支持 | 默认开启 | 1–16 秒 | 720p |
viduq3-turbo | 支持 | 支持 | 支持 | 支持 | 默认开启 | 1–16 秒（参考生 3–16 秒） | 720p |
上表为当前在售型号，以模型广场为准。各接口页的参数表保留了 Vidu 官方对其他型号的说明，未上架的型号调用会返回 model_not_found。 任务状态#
| 状态 | 含义 |
|---|
created | 创建成功 |
queueing | 排队中 |
processing | 处理中 |
success | 生成成功 |
failed | 生成失败 |
回调通知#
创建任务接口均支持 callback_url 参数。设置后，任务状态变化时 Vidu 以 POST 方式向该地址发送回调，内容结构与查询任务的返回一致。回调状态包括 processing、success、failed，失败时最多重试 3 次。相关文档#
