Text-to-video

The request body preserves Vidu's native payload structure, while the platform handles API key authentication and request forwarding.

POST/vidu/ent/v2/text2video

The platform handles authentication and intelligent routing, while the request payload is passed through using Vidu native fields.

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

Vidu native text-to-video request.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Vidu model ID, such as viduq3-pro, viduq2, viduq1, vidu2.0, or vidu1.5. Available models are determined by the model list returned for the current API key.

Length1 <= length

prompt*string

Describe the video content to generate.

Length1 <= length

duration?integer

Video duration in seconds.

Value in

resolution?string

Output resolution.

Value in

"720p"
"1080p"

aspect_ratio?string

Output aspect ratio.

Value in

"16:9"
"9:16"
"1:1"

movement_amplitude?string

Motion amplitude, such as low, medium, or high.

audio?boolean

Whether to generate audio.

audio_type?string

Audio type.

bgm?boolean

Whether to generate background music.

style?string

Generation style.

watermark?boolean

Whether to include a watermark in the result.

off_peak?boolean

Whether to use off-peak mode.

callback_url?string

Task status callback URL.

Formaturi

Response Body

`application/json`

curl -X POST "https://example.com/vidu/ent/v2/text2video" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A running cyberpunk-style horse",    "duration": 5,    "resolution": "720p",    "aspect_ratio": "16:9",    "audio": true  }'

No example response

The video task was submitted successfully. The response uses Vidu's native task structure.

Authorization

Request Body

Response Body

200

400application/json

401application/json

`application/json`

`application/json`