Skip to Content

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_00000000000000000000000000000000

Endpoints

1. Create Task

Request

POST https://api.pixwithapi.online/api/task/create

Headers

HeaderValueRequired
Content-Typeapplication/jsonYes
Api-Key{API_KEY}Yes

Request Parameters

ParameterTypeRequiredDescription
promptstringYesThe scene and motion prompt.
image_urlsarrayConditionalOmit 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_idstringYes2-58 for every mode.
optionsobjectYesConfiguration options for the task.
options.prompt_optimizationbooleanYesOptimize the prompt before generation. Default: true.
options.resolutionstringYesValid values: '720p', '1080p'. Default: '720p'.
options.durationintYesValid values: 5, 10, 15. Default: 5.
options.aspect_ratiostringConditionalText-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.soundbooleanNoGenerate 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

ParameterTypeDescription
codeint1=success, 0=error
messagestringSuccess and failure messages
dataobjectTask data
data.task_idstringPixwith task ID
data.estimated_timeintEstimated time in seconds

Response

{ "code": 1, "message": "success", "data": { "task_id": "d425ab4dc256f0ebaa84862b9cea8a3d", "estimated_time": 510 } }
Last updated on