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: viduq1_i2v_reference
prompt string required
Text prompt, can use @subject_id to reference subject content. Max 2000 characters.
images array required
Reference image URLs. Supports 1-7 images total across subjects.
voice_id string
Voice ID for audio. Leave empty for auto-recommended voice.
audio boolean
Enable audio-video output capability.
seed integer
Random seed for reproducibility.
duration integer
Video duration in seconds. Fixed at 5 seconds.
Default: 5
resolution string
Video resolution. Fixed at 1080p.
Default: 1080p
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 |