创建视频

使用平台统一请求结构提交公共字段，并通过 metadata 传递 Vidu 专属参数。

POST/v1/video/generations

通过平台公共视频任务入口创建 Vidu 任务。平台会将公共字段映射到对应的 Vidu 生成能力。

Vidu 模型包括 viduq3-pro、viduq2、viduq1、vidu2.0 和 vidu1.5。示例使用 MODEL_ID，实际可用模型以当前 API Key 返回的模型列表为准。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Vidu 平台格式视频创建请求。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Vidu 视频模型 ID。实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

描述期望生成的视频内容。

Length1 <= length

images?array<string>

参考图片 URL 列表。文生视频可省略；图生视频通常传入 1 张；首尾帧模式传入 2 张；参考图模式可以传入多张。

image?string

部分兼容客户端使用的单张参考图片 URL。

size?string

输出分辨率，例如 720p 或 1080p，对应 Vidu 的 resolution。

duration?integer

视频时长，单位为秒。

Value in

metadata?

Vidu 专用扩展参数。

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一只奔跑的赛博朋克风格的马，背后是霓虹闪烁的未来城市",    "size": "720p",    "duration": 5  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`