Skip to Content
Video ModelsVidu Q3 Reference to Video

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_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
promptstringYesDescribe the scene, subjects, action, and camera motion.
image_urlsarrayYesProvide 1–4 reference image URLs.
model_idstringYes2-59.
optionsobjectYesConfiguration options for the task.
options.prompt_optimizationbooleanYesOptimize the prompt before generation. Default: true.
options.aspect_ratiostringYesValid values: '16:9', '9:16', '4:3', '3:4', '1:1'. Default: '16:9'.
options.resolutionstringYesValid values: '720p', '1080p'. Default: '720p'.
options.durationintYesValid values: 5, 10, 15. Default: 5.
options.soundbooleanNoGenerate 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

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": 300 } }
Last updated on