Vidu Q2 I2V Reference

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_KEY

Parameters

model string required

Model ID to use for the request.

Value: viduq2_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.

---

duration integer

Video duration in seconds.

Range: 1 - 10

---

resolution string

Video resolution.

---

seed integer

Random seed for reproducibility.

---

aspect_ratio string

Video aspect ratio.

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