Vidu Q3
Overview
Vidu Q3 supports text-to-video, single-image animation, and start/end-frame video generation with optional synchronized audio on Pixwith API.
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 | The scene and motion prompt. |
| image_urls | array | Conditional | Omit for text-to-video. Provide exactly 1 image for image-to-video, or exactly 2 images for start/end-frame generation. The first image is the start frame and the second is the end frame. |
| model_id | string | Yes | 2-58 for every mode. |
| options | object | Yes | Configuration options for the task. |
| options.prompt_optimization | boolean | Yes | Optimize the prompt before generation. Default: true. |
| options.resolution | string | Yes | Valid values: '720p', '1080p'. Default: '720p'. |
| options.duration | int | Yes | Valid values: 5, 10, 15. Default: 5. |
| options.aspect_ratio | string | Conditional | Text-to-video only. Valid values: '16:9', '9:16', '4:3', '3:4', '1:1'. Default: '4:3'. Do not send it with images. |
| options.sound | boolean | No | Generate synchronized audio and background music. Default: true. |
Example Request - Text-to-Video
{
"prompt": "A cinematic train crossing a mountain bridge at sunrise",
"model_id": "2-58",
"options": {
"prompt_optimization": true,
"resolution": "720p",
"duration": 5,
"aspect_ratio": "4:3",
"sound": true
}
}Example Request - Image-to-Video (single image)
{
"prompt": "The camera slowly pushes forward while the subject turns toward the light",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_start.jpeg"
],
"model_id": "2-58",
"options": {
"prompt_optimization": true,
"resolution": "1080p",
"duration": 10,
"sound": true
}
}Example Request - Start/End Frames (two images)
{
"prompt": "Create a smooth cinematic transition between the two frames",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_start.jpeg",
"https://cdn.pixwithapi.online/images/example_end.jpeg"
],
"model_id": "2-58",
"options": {
"prompt_optimization": true,
"resolution": "720p",
"duration": 15,
"sound": false
}
}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": 510
}
}Last updated on