UlazAI fejlesztői dokumentumok
Vidu Q4 API
Vidu Q4 reference
Create Vidu Q4 video tasks
Send requests to POST /api/v1/video-studio/generate/ with
vidu_q4_i2v or vidu_q4_r2v as the model slug.
Check progress with GET /api/v1/video-studio/status/{job_id}/.
Create
POST /api/v1/video-studio/generate/
GET /api/v1/video-studio/status/{job_id}/
Models
vidu_q4_i2v
vidu_q4_r2v
Output
3-16 seconds
540p, 720p, 1080p, 2K or 4K
Parameters
| Field | Type | Limits and combinations |
|---|---|---|
model_slug | string | vidu_q4_i2v or vidu_q4_r2v. |
prompt | string | Optional for vidu_q4_i2v, required for vidu_q4_r2v. Maximum 20,000 characters. On r2v, address references by order, e.g. "the man in reference image 2". |
input_image_urls | array | i2v: exactly one http(s) URL, JPG, PNG or WebP, max 50 MB. The clip inherits the ratio of this image. |
reference_image_urls | array | r2v: 1-15 http(s) URLs, JPG, PNG or WebP, max 50 MB each. |
reference_audio_urls | array | r2v only: up to 3 MP3 URLs, 3-12 seconds each, max 50 MB. Other audio formats are refused. |
duration_seconds | integer | 3-16, default 5. |
quality_mode | string | 540p, 720p (default), 1080p, 2k or 4k. |
aspect_ratio | string | r2v: 16:9 (default), 9:16, 1:1, 4:3 or 3:4. i2v takes no ratio: sending one is refused with a 400 because the clip keeps the image's ratio. |
sound | boolean | On by default. Native audio is generated with the video; it does not change the price. |
Credit rates per second
The same rate applies to both models, with and without audio.
| Resolution | Credits per second | Example |
|---|---|---|
| 540p | 8.64 credits/s | 3 s = 26 credits |
| 720p | 18.24 credits/s | 5 s = 92 credits |
| 1080p | 23.04 credits/s | 5 s = 116 credits |
| 2k | 36.48 credits/s | 5 s = 183 credits |
| 4k | 74.88 credits/s | 16 s = 1,199 credits |
Each clip is rounded up to a whole credit after the rate is applied.
Create a task
Image to video
{
"model_slug": "vidu_q4_i2v",
"input_image_urls": ["https://media.ulazai.com/examples/vidu-q4-still.jpg"],
"prompt": "Slow push-in while the steam keeps rising",
"duration_seconds": 5,
"quality_mode": "720p",
"sound": true
}Reference images to video
{
"model_slug": "vidu_q4_r2v",
"prompt": "The man in reference image 2 hands the bottle from reference image 1 to the woman in reference image 3",
"reference_image_urls": [
"https://media.ulazai.com/examples/vidu-q4-bottle.jpg",
"https://media.ulazai.com/examples/vidu-q4-man.jpg",
"https://media.ulazai.com/examples/vidu-q4-woman.jpg"
],
"reference_audio_urls": ["https://media.ulazai.com/examples/vidu-q4-voice.mp3"],
"duration_seconds": 8,
"quality_mode": "1080p",
"aspect_ratio": "16:9",
"sound": true
}Send either payload to POST /api/v1/video-studio/generate/ with your UlazAI API key.
Poll a task
curl -X GET '/api/v1/video-studio/status/{job_id}/' \
-H 'Authorization: Bearer YOUR_API_KEY'The response contains success and job. Read job.status for progress and, after completion, the video URLs from job.result_urls.