Authentication
authorization string required
All APIs require authentication via Bearer Token.
Get API Key:
Visit API Key Management Page to get your API Key
Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEYParameters
model string required
Model ID to use for the request.
Value: vidu_20_i2v
images array required
Start frame image. Only accepts 1 image. Supports URL or Base64.
prompt string
Video generation prompt. Max 2000 characters.
audio boolean
Enable audio-video output capability.
voice_id string
Voice ID for audio. Leave empty for auto-recommended voice.
is_rec boolean
Use recommended prompt.
duration integer
Video duration in seconds.
resolution string
Video resolution.
Options: 360p, 720p, 1080p for 4s; 720p for 8s
seed integer
Random seed for reproducibility.
aspect_ratio string
Video aspect ratio.
movement_amplitude string
Movement amplitude of objects in frame.
Error Codes
| Code | Description |
|---|---|
| 401 | API key is missing or invalid |
| 403 | Insufficient balance or permission denied |
| 429 | Rate limit exceeded |
| 500 | Internal server error |