Image Generation

Data exchange format

Replace {your api key} with your token

Model name
Optional values: viduq2, viduq1
viduq2: Supports text-to-image, image editing, and reference-to-image
viduq1: Supports reference-to-image

Image reference
viduq2: Supports input of 0–7 images
viduq1: Supports input of 1–7 images
The model uses the subject in the images passed in this parameter as a reference, and generates a video with a subject consistent with the images.
Note 1: Supports passing images as Base64 encoding or image URL (ensure it is accessible)
Note 2: Images support png, jpeg, jpg, webp formats
Note 3: Image pixel dimensions must not be smaller than 128*128, and the aspect ratio must be less than 1:4 or 4:1
Note 4: The size must not exceed 50M
Note 5: Please note that the post body of the http request must not exceed 20MB, and the encoding must include an appropriate content type string, for base64,{base64_encode}normal

Text prompt
Text description for video generation, must not exceed 2000 characters
Note 1: The viduq2 model supports text-to-image; when using the viduq2 model without uploading any images, the model will use the text content of this parameter to generate an image

Random seed parameter
If not passed or set to 0 by default, a random number will be used instead
If manually set, the specified seed will be used

Aspect ratio parameter; different models support different ratios:
viduq1: Default value 16:9, optional values: 16:9, 9:16, 1:1, 3:4, 4:3
viduq2: Default value 16:9, optional values as follows: 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, ,

Resolution parameter; different models support different resolutions:
viduq1: Default 1080p, options: 1080p
viduq2: Default 1080p, options: 1080p, 2K, 4K

Pass-through parameter
No processing is done, only data transmission
Note: Maximum 1048576 characters

Callback protocol
You need to actively set callback_url when creating the task. The request method is POST. When the video generation task status changes, Vidu will send a callback request containing the latest task status to this address. The callback request content structure is consistent with the response body of the Query Task API
The "status" returned in the callback includes the following states:

• processing Task is processing
• success Task completed (callback sent up to three times if delivery fails)
• failed Task failed (callback sent up to three times if delivery fails)
  Vidu uses a callback signature algorithm for authentication. For details, see: Callback Signature Algorithm

Replace {your api key} with your token

Task ID, returned upon successful creation by the create task endpoint