Vidu Q3 Reference to Video
Overview
Vidu Q3 Reference to Video creates a new video guided by a prompt and 1–4 reference images while preserving subjects, style, and scene elements. It is an image-input-only model.
Test API KEY: key_00000000000000000000000000000000Endpoints
1. Create Task
Request
POST https://api.pixwithapi.online/api/task/createHeaders
| Header | Value | Required |
|---|---|---|
| Content-Type | application/json | Yes |
| Api-Key | {API_KEY} | Yes |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | Describe the scene, subjects, action, and camera motion. |
| image_urls | array | Yes | Provide 1–4 reference image URLs. |
| model_id | string | Yes | 2-59. |
| options | object | Yes | Configuration options for the task. |
| options.prompt_optimization | boolean | Yes | Optimize the prompt before generation. Default: true. |
| options.aspect_ratio | string | Yes | Valid values: '16:9', '9:16', '4:3', '3:4', '1:1'. Default: '16:9'. |
| options.resolution | string | Yes | Valid values: '720p', '1080p'. Default: '720p'. |
| options.duration | int | Yes | Valid values: 5, 10, 15. Default: 5. |
| options.sound | boolean | No | Generate synchronized audio. Default: true. |
Example Request - Reference to Video
{
"prompt": "The two referenced characters meet in a neon-lit street and walk toward the camera",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_reference_1.jpeg",
"https://cdn.pixwithapi.online/images/example_reference_2.jpeg"
],
"model_id": "2-59",
"options": {
"prompt_optimization": true,
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 10,
"sound": true
}
}Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | int | 1=success, 0=error |
| message | string | Success and failure messages |
| data | object | Task data |
| data.task_id | string | Pixwith task ID |
| data.estimated_time | int | Estimated time in seconds |
Response
{
"code": 1,
"message": "success",
"data": {
"task_id": "d425ab4dc256f0ebaa84862b9cea8a3d",
"estimated_time": 300
}
}Last updated on