Vidu Q3 Pro
Overview
Vidu Q3 Pro supports fast 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-60 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.sound | boolean | No | Generate synchronized audio and background music. Default: true. |
Example Request - Text-to-Video
{
"prompt": "A cinematic night drive through a neon city in light rain",
"model_id": "2-60",
"options": {
"prompt_optimization": true,
"resolution": "720p",
"duration": 5,
"sound": true
}
}Example Request - Image-to-Video (single image)
{
"prompt": "Subtle wind moves the clothing as the camera slowly pulls back",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_start.jpeg"
],
"model_id": "2-60",
"options": {
"prompt_optimization": true,
"resolution": "1080p",
"duration": 10,
"sound": true
}
}Example Request - Start/End Frames (two images)
{
"prompt": "Create a fluid transition from the opening frame to the final frame",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_start.jpeg",
"https://cdn.pixwithapi.online/images/example_end.jpeg"
],
"model_id": "2-60",
"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": 300
}
}Last updated on