Replace {your api key} with your token

Model name

• viduq2-pro: New model with excellent performance and rich details

The first frame image
The model uses the image passed in this parameter as the first frame to generate the video.
Note 1: Accepts a Base64-encoded image or an image URL (make sure it is accessible);
Note 2: Only 1 image is supported;
Note 3: Supported formats: png, jpeg, jpg, webp;
Note 4: The aspect ratio of the image must be less than 1:4 or 4:1;
Note 5: The image size must not exceed 50 MB;
Note 6: Note that the byte length after base64 decode must be less than 10M, and the encoding must include an appropriate content type string, for base64,{base64_encode}normal

Text prompt
A textual description for video generation.
Note 1: The length must not exceed 2000 characters
Note 2: If the is_rec recommended prompt parameter is used, the model will ignore the prompt entered in this parameter

Whether to use the direct audio-video generation capability. Default: false. Enumerated values:

• false: No direct audio-video generation, outputs a silent video
• true: Direct audio-video generation required, outputs a video with dialogue and background sound
  Note 1: The voice_id parameter takes effect only when this parameter is true
  Note 2: When this parameter is true, off-peak mode is not supported

Voice ID. Used to determine the voice character in the video. If empty, the system will automatically recommend one. For the optional values, refer to the list: Voice List
You can also use the Voice Cloning API to clone any voice. The voice_id can be used interchangeably

Whether to use the recommended prompt.

• true: Yes, the system will automatically recommend a prompt and use its content to generate the video. Number of recommended prompts = 1
• false: No, the video will be generated based on the input prompt
  Note: When the recommended prompt feature is enabled, each task consumes an additional 10 credits

Video duration
For viduq2-pro, the default is 5. Available values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Random seed
If not passed or passed as 0, a random number will be used instead
A manually set value will be used as the seed

Resolution. The default value depends on the model and video duration:

• viduq2-pro 2-8s: default 720p, options: 540p, 720p, 1080p

Transparent transmission parameter
No processing, data transmission only
Note: Maximum of 1048576 characters

Off-peak mode. Default: false. Accepted values:

• true: Generate the video in off-peak mode;
• false: Generate the video immediately;
  Note 1: Off-peak mode consumes fewer credits. For details, see Pricing
  Note 2: Tasks submitted in off-peak mode will be generated within 48 hours. Tasks that are not completed will be automatically cancelled and the credits will be refunded;
  Note 3: You can also manually cancel an off-peak task

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

• processing: task is being processed
• success: task completed (if sending fails, the callback will be retried three times)
• failed: task failed (if sending fails, the callback will be retried three times)
  Vidu uses a callback signature algorithm for authentication. For details, see the Callback Signature Algorithm

Replace {your api key} with your token

Task ID. Returned by the Create Task API upon successful creation

Replace {your api key} with your API key

Model name
Accepted values: viduq2-turbo

• viduq2-turbo: New model with good effect, fast generation

An image to be used as the start frame of the generated video. The model will generate the video using the image provided in this parameter as the start frame.
Note 1: Accepts a public image URL (make sure it is accessible) or Base64 format.
Note 2: Only accepts 1 image.
Note 3: Supported formats: png, jpeg, jpg, webp.
Note 4: The aspect ratio of the image must be less than 1:4 or 4:1.
Note 5: The image size is limited to 50MB.
Note 6: The byte length after Base64 decoding must be less than 10MB, and the encoding must include an appropriate content type string. For instance:
data:image/png;base64,{base64_encode}

Text prompt
A textual description for video generation.
Note 1: The maximum length is 2000 characters.
Note 2: If the is_rec parameter for recommended prompts is used, the model will ignore the manually entered prompt for this parameter.

Whether to use the direct audio-video generation capability. Default: false. Enumerated values:

• false: No direct audio-video generation, outputs silent video.
• true: Direct audio-video generation required, outputs video with dialogue and background sound.
  Note 1: The voice_id parameter takes effect only when this parameter is true.
  Note 2: When this parameter is true, off peak mode is not supported.

Voice ID
Used to determine the voice character in the video. If left empty, the system will automatically recommend a suitable voice, and optional values can be found in the Voice List. You can also use the Voice Cloning API to clone any voice. The voice_id parameters can be used interchangeably.

Whether to use the recommended prompt.

• true: Yes, the system will automatically generate and apply a recommended prompt to create the video. The number of recommended prompts = 1.
• false: No, the video will be generated based on the user-provided prompt.
  Note: When the recommended prompt feature is enabled, each task will consume an additional 10 credits.

Video duration.
viduq2-turbo: default 5s, available: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Random seed
If this parameter is not provided or is set to 0, a random seed number will be used. Manually set values will be used as the seed.

Resolution. The default value depends on the model and video duration.

• viduq2-turbo (2-8s): default 720p, options: 540p, 720p, 1080p

Transparent transmission parameters
No processing, only data transmission.
Note: Maximum length of 1048576 characters.

Off peak mode. Default: false. Accepted values:

• true: generate the video in off peak mode
• false: generate the video immediately
  Note 1: Off peak mode consumes fewer credits. For details, please refer to Pricing.
  Note 2: Tasks submitted in off peak mode will be generated within 48 hours. Tasks that are not completed will be automatically cancelled and their credits will be refunded.
  Note 3: You can also manually cancel off peak tasks.

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 Video Generation Task 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

Replace {your api key} with your API key

Task ID. Returned by the task creation API upon successful creation.