Vidu 视频
Vidu 视频系列目前提供三套接入方式：官方格式（/vidu/ent/v2/*）、OpenAI 兼容的 /v1/videos（multipart/form-data 格式），以及统一视频的 /v1/video/create 与 /v1/video/query（JSON）。
官方格式
使用/vidu/ent/v2/* 系列接口，支持多种视频生成模式。
文生视频
POST /vidu/ent/v2/text2video，纯文本生成视频。图生视频
POST /vidu/ent/v2/img2video，首帧图生成视频。首尾帧生视频
POST /vidu/ent/v2/start-end2video，首尾帧生成视频。参考生视频
POST /vidu/ent/v2/reference2video，主体参考生成视频。查询任务
GET /vidu/ent/v2/task/{task_id}/creations，查询任务状态与结果。支持模型（官方格式）
| 模型 | 说明 | 时长规则 |
|---|---|---|
viduq3-pro | 高效生成优质音视频内容 | 按模型而定 |
viduq2 / viduq2-pro | 新模型，效果好，细节丰富 | 1-10 秒 |
viduq2-turbo | 新模型，效果好，生成快 | 1-10 秒 |
viduq1 / viduq1-classic | 画面清晰，平滑转场 | 按模型而定 |
vidu2.0 | 生成速度快 | 按模型而定 |
OpenAI 格式
使用POST /v1/videos 提交、GET /v1/videos/{task_id} 查询，以 multipart/form-data 提交。
视频生成
POST /v1/videos，提交 Vidu 视频任务。任务状态查询
GET /v1/videos/{task_id}，查询任务状态与结果。支持模型（OpenAI 格式）
| 模型 | 说明 |
|---|---|
viduq3-pro | 高效生成优质音视频内容，让视频内容更生动、更形象、更立体 |
viduq2-pro | 新模型，效果好，细节丰富 |
viduq2-turbo | 新模型，效果好，生成快 |
统一视频
使用POST /v1/video/create 创建任务，查询使用 GET /v1/video/query?id=。
生成视频
POST /v1/video/create，统一视频格式提交 Vidu 任务。查询任务
GET /v1/video/query，按任务 id 查询状态与结果。常见能力（统一视频）
| 能力 | 传参方式 | 说明 |
|---|---|---|
| 文生视频 | images: [] | 仅文本提示 |
| 首帧生视频 | images 1 张 | 首帧图 + 文本提示 |
| 首尾帧生视频 | images 2 张 | 首帧 + 尾帧 |
| 参考生视频 | subjects 数组 | 主体参考图 |
对比
| 项目 | 官方格式 | OpenAI 格式 | 统一视频 |
|---|---|---|---|
| 创建 | /vidu/ent/v2/* | POST /v1/videos | POST /v1/video/create |
| 查询 | GET /vidu/ent/v2/task/{task_id}/creations | GET /v1/videos/{task_id} | GET /v1/video/query?id= |
| 请求格式 | JSON | multipart/form-data | JSON |
| 参考图 | images / subjects | images | images |
| 画幅 | aspect_ratio | aspect_ratio | aspect_ratio |
| 分辨率 | resolution | resolution | size |
| 时长 | duration | duration | duration |
参数约束
| 字段 | 可用值 | 说明 |
|---|---|---|
aspect_ratio | 16:9、9:16、3:4、4:3、1:1 | 3:4、4:3 仅支持 q2、q3 模型 |
resolution | 540p、720p、1080p | 分辨率规格 |
duration | 1-10 | 视频时长（秒），q2 默认 5 |
style | general、anime | 风格（q2、q3 不生效） |
特色功能
| 功能 | 说明 |
|---|---|
| 音视频直出 | audio: true，输出带台词和音效的视频（仅 q3） |
| 背景音乐 | bgm: true，自动添加 BGM |
| 错峰模式 | off_peak: true，错峰生成，积分更低 |
| 推荐提示词 | is_rec: true，系统自动推荐提示词 |
| 水印 | watermark: true，添加固定水印 |