Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Vidu Q4 image-to-video and reference-to-video with up to 15 images and 3 audio references, 540p to 4K. See parameters and API examples.
vidu/q4
| Mode | How to select it | Length | Shape |
|---|---|---|---|
| Image-to-video | Send image_url | 3-16 seconds | Follows the input image |
| Reference-to-video | Send reference_image_urls (and optionally reference_audio_urls) | 1-16 seconds | aspect_ratio |
image_url or reference_image_urls, not both.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | Video prompt, 1-5000 characters. In reference-to-video, mention inputs as [Image1]-[Image15] and [Audio1]-[Audio3] |
image_url | string | Conditional | null | Image-to-video: public URL of the image to animate. Required unless reference_image_urls is set |
reference_image_urls | string[] | Conditional | null | Reference-to-video: 1-15 public image URLs. [Image1] is the first URL |
reference_audio_urls | string[] | No | null | Reference-to-video only: up to 3 public audio URLs (wav, mp3, aac, ogg, flac, aiff), 1-16 seconds and up to 20 MB each. [Audio1] is the first URL |
resolution | string | No | "1080p" | "540p", "720p", "1080p", "2k", or "4k" |
duration | integer | No | 5 | Image-to-video: 3-16 seconds. Reference-to-video: 1-16 seconds |
aspect_ratio | string | No | "16:9" | Reference-to-video only: "16:9", "9:16", "1:1", "4:3", or "3:4" |
video_format | string | No | "h264_pro" | "h264", "h264_pro", "h265", or "h265_pro". Same price; the pro variants encode at higher quality |
enhance_prompt | boolean | No | true | Let Vidu rewrite the prompt before generating |
nsfw_check | boolean | No | true | Check uploaded media inputs for NSFW content |
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "vidu/q4",
"input": {
"prompt": "The cat slowly turns its head toward the camera and meows softly",
"image_url": "https://example.com/cat.jpg",
"resolution": "1080p",
"duration": 8
}
}'
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "vidu/q4",
"input": {
"prompt": "[Image1] picks up the apple from [Image2] and says the line from [Audio1]",
"reference_image_urls": [
"https://example.com/person.jpg",
"https://example.com/apple.jpg"
],
"reference_audio_urls": ["https://example.com/voice.mp3"],
"resolution": "4k",
"duration": 8,
"aspect_ratio": "9:16"
}
}'
{
"code": 200,
"success": true,
"data": {
"task_id": "abc123def456",
"status": "processing"
}
}
GET /v1/tasks/<task_id> or set a callback_url on the request to receive the finished video.