Vidu 视频生成全量接口文档 (OpenAI & 原生格式)¶
本接口通过 new-api 提供两种调用方式：
1. OpenAI 兼容模式：适用于标准视频客户端，参数经过映射。
2. 原生转发模式：参数结构完全对齐原厂文档，适合直接集成。
1. OpenAI 兼容调用格式 (推荐)¶
- 接口地址:
POST /v1/video/generations - 认证方式:
Authorization: Bearer $API_KEY
1.0 基础调用示例（curl）¶
curl https://api.agtcloud.ai/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "viduq3-pro",
"prompt": "一只奔跑的赛博朋克风格的马，背后是霓虹闪烁的未来城市，科幻感，极高画质",
"size": "720p",
"duration": 5
}'
上面示例会被 new-api 自动映射到 Vidu 文生视频接口（720p，5s）。
1.1 基础参数映射¶
| OpenAI 字段 | 类型 | 说明 | 对应原厂逻辑 |
|---|---|---|---|
model |
string | 模型名称，如 viduq3-pro, viduq2, viduq1 |
自动匹配后端接口 |
prompt |
string | 正向提示词 | 映射至 prompt |
images |
array | 参考图 URL 列表 | 映射至 images |
size |
string | 尺寸，如 720p, 1080p |
映射至 resolution |
duration |
number | 时长 (s)，支持 5, 10 | 映射至 duration |
1.2 高级扩展参数 (Extra Parameters)¶
所有非 OpenAI 标准的字段必须放在 metadata 对象中（或在支持自定义 JSON 的客户端中放在最外层）。
适用于 Vidu 系列模型:
{
"model": "viduq3-pro",
"prompt": "赛博朋克风格的马",
"metadata": {
"aspect_ratio": "16:9", // 宽高比: 16:9, 9:16, 1:1
"movement_amplitude": "medium", // 运动幅度: low, medium, high
"bgm": true, // 是否生成背景音乐
"audio": true, // 是否生成音频
"audio_type": "vocal", // 音频类型
"style": "anime", // 风格
"watermark": false, // 是否包含水印
"off_peak": false, // 是否使用闲时模式
"callback_url": "https://..." // 回调地址
}
}
1.2.1 携带高级参数的完整 curl 示例¶
curl https://api.agtcloud.ai/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "viduq3-pro",
"prompt": "一只奔跑的赛博朋克风格的马，背后是霓虹闪烁的未来城市，科幻感，极高画质",
"size": "1080p",
"duration": 5,
"metadata": {
"aspect_ratio": "16:9",
"movement_amplitude": "high",
"audio": true,
"style": "realistic",
"watermark": false
}
}'
2. 原生转发模式 (Native API)¶
如果你希望直接使用原厂文档定义的结构，可以使用以下路径。此路径下 new-api 仅做鉴权和智能路由，不修改你的 Payload。
- 文生视频:
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/tasks/{task_id}/creations
2.0 文生视频调用示例（curl）¶
curl https://api.agtcloud.ai/vidu/ent/v2/text2video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "viduq3-pro",
"prompt": "一只奔跑的赛博朋克风格的马",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}'
2.0.1 首尾帧生视频调用示例（curl）¶
curl https://api.agtcloud.ai/vidu/ent/v2/start-end2video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "viduq2",
"prompt": "保持主体风格不变，让角色缓慢走向镜头",
"images": [
"https://example.com/start-frame.jpg",
"https://example.com/end-frame.jpg"
],
"duration": 5,
"resolution": "720p"
}'
2.1 全量参数说明 (Vidu V2)¶
{
"model": "string", // 模型名称
"prompt": "string", // 提示词
"images": ["url1", "url2"], // 参考图列表
"duration": 5, // 5, 10
"resolution": "720p", // 720p, 1080p
"aspect_ratio": "16:9", // 16:9, 9:16, 1:1
"movement_amplitude": "medium",
"audio": true,
"audio_type": "string",
"bgm": true,
"style": "string",
"watermark": false,
"off_peak": false,
"callback_url": "url"
}
参数限制¶
| 参数 | 限制 |
|---|---|
model |
枚举：viduq3-pro、viduq2、viduq1、vidu2.0、vidu1.5 |
duration |
整数：5、10 |
resolution |
枚举：720p、1080p |
aspect_ratio |
枚举：16:9、9:16、1:1 |
images |
文生视频时为空；图生视频时通常 1 张；首尾帧生视频时 2 张；参考图生视频时可多张 |
3. 任务状态常量说明 (通用)¶
| 状态文本 (OpenAI) | 状态代码 (原生) | 描述 |
|---|---|---|
queued |
queueing / created | 排队中 / 已创建 |
processing |
processing | 处理中 |
succeeded |
success | 成功 |
failed |
failed | 失败 |
关于查询接口¶
提交任务后，可以使用任务 ID 进行状态查询。
1. OpenAI 风格查询 (推荐)¶
适用于标准 OpenAI 视频响应格式。
curl https://api.agtcloud.ai/v1/video/generations/task_id_here \
-H "Authorization: Bearer $API_KEY"
2. 原生风格查询¶
返回原厂定义的原始响应结构。