Vidu Reference-to-Video viduq3
Generate videos using the Vidu model based on reference subjects. Supports defining characters/objects through images and text, and referencing them in prompts. After submission, query status via GET /vidu/ent/v2/tasks/{task_id}. Uses model viduq3.
Authorizations
Body
List of subjects.
- When using q3, q2, q1, and 2.0 series models, only image and text subjects can be used, with a maximum of 7 subjects
- When using the q2-pro model, video subjects, text subjects, and image subjects can be employed, with no more than 4 image or text subjects, and no more than 2 video subjects (or 1 temporary video subject)
- viduq3-mix does not support the use of entities for the time being
1 - 7 elementsResolution (based on model & duration):
- viduq3, viduq3-turbo (3-16s): default 720p, options: 540p, 720p, 1080p
- viduq2 (1-10s): default 720p, options: 540p, 720p, 1080p
- viduq1 (5s): default 1080p, options: 1080p
- vidu2.0 (4s): default 360p, options: 360p, 720p
360p, 540p, 720p, 1080p Off peak mode.
- true: Off peak generate mode
- false: Normal generate mode Notes:
- The off_peak mode consumes lower points (see Pricing for details)
- Tasks submitted in off peak mode will be generated within 48 hours. Tasks that are not completed will be automatically cancelled and their points will be refunded
- We also support cancel off_peak tasks
- The q3 model supports peak-shifting tasks when the audio parameter is true; the q2, q1, and 2.0 series models support peak-shifting tasks when the audio parameter is false
Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the GET Generation API. The "status" in the callback response includes the following states:
- processing: Task is being processed.
- success: Task is completed (if sending fails, it will retry the callback three times).
- failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature
Response
Submission successful, returns a video task object.