Create a video

Use the unified platform request structure for common fields and pass Vidu-specific parameters through metadata.

POST/v1/video/generations

Create Vidu tasks through the platform's public video task entry. The platform maps public fields to the corresponding Vidu generation capabilities. The Vidu models include viduq3-pro, viduq2, viduq1, vidu2.0, and vidu1.5. The example uses MODEL_ID, and the actual available models are based on the model list returned by the current API Key

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

application/json

Vidu platform format video creation request.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Vidu video model ID. The actual available models are based on the model list returned by the current API Key.

Length1 <= length

prompt*string

Describe the video content you expect to generate.

Length1 <= length

images?array<string>

List of reference image URLs. Text-to-video can be omitted; Image-to-video usually passes in 1 frame; Front-to-end frame mode fetchs 2 images; Reference image mode can send multiple images.

image?string

Partial compatibility with single reference image URLs used by clients.

size?string

output resolution, such as 720p or 1080p, corresponding to Vidu's resolution.

duration?integer

Video duration, measured in seconds.

Value in

metadata?

Vidu-specific extension parameters.

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A running cyberpunk-style horse, with a neon-lit futuristic city behind it",    "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`