Reference to Video


POST https://api.vidu.com/ent/v2/reference2video

Request Header

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token {your api key}	Replace {} with your API key

Request Body

Field	Type	Required	Description
model	String	Required	Model name Accepted values: viduq1 vidu2.0 vidu1.5
images	Array[String]	Required	The model will use the provided images as references to generate a video with consistent subjects For fields that accept images: -Accepts 1 to 7 images. - Images Assets can be provided via URLs or Base64 encode. - You must use one of the following codecs: PNG, JPEG, JPG, WebP - The dimensions of the images must be at least 128x128 pixels - The aspect ratio of the images must be less than 1:4 or 4:1 - All images are limited to 50MB - The length of the base64 decode must be under 10MB, and it must include an appropriate content type string. For instance, data:image/png;base64,{base64_encode}
prompt	String	Required	Text prompt A textual description for video generation, with a maximum length of 1500 characters
duration	Int	Optional	Video duration parameter, with default values depending on the model: - viduq1: Default is 5 seconds, available option: 5 - vidu2.0: Default is 4 seconds, available option: 4 - vidu1.5: Default is 4 seconds, available options: 4, 8
seed	Int	Optional	Random seed - Defaults to a random seed number - Manually set values will override the default random seed
aspect_ratio	String	Optional	The aspect ratio of the output video Defaults to 16:9, accepted: 16:9 9:16 1:1
resolution	String	Optional	Resolution parameter, with default values depending on the model and video duration: - viduq1 (5s): Default is 1080p, available option: 1080p - vidu2.0 (4s): Default is 360p, available options: 360p, 720p - vidu1.5 (4s): Default is 360p, available options: 360p, 720p, 1080p - vidu1.5 (8s): Default is 720p, available option: 720p
movement_amplitude	String	Optional	The movement amplitude of objects in the frame Defaults to auto, accepted value: auto small medium large
bgm	Bool	Optional	Whether to add background music to the generated video. Default: false. Acceptable values: true, false. When true, the system will automatically add a suitable BGM. BGM has no time limit and the system automatically adapts.
payload	String	Optional	transparent transmission parameters No processing, only data transmission，with a maximum length of 1048576 characters
callback_url	String	Optional	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


curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
    "model": "viduq1",
    "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"],
    "prompt": "Santa Claus and the bear hug by the lakeside.",
    "duration": "5",
    "seed": "0",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "bgm": "false",
    "movement_amplitude": "auto"
}' https://api.vidu.com/ent/v2/reference2video

Response Body

Field	Type	Description
task_id	String	Task ID
state	String	It will be returned to a specific processing state: - created created task successfully - queueing task in queue - processing processing - success generation successful - failedtask failed
model	String	The parameter of the model used for this call
images	Array[String]	The image used for this call
prompt	String	The text prompt used for this call
duration	Int	The video duration parameter used for this call
seed	Int	The random seed parameter used for this call
aspect_ratio	String	The aspect ratio parameter used for this call
resolution	String	The resolution parameter used for this call
bgm	bool	The bgm parameter used for this call
movement_amplitude	String	The camera movement amplitude parameter used for this call
payload	String	The payload parameter used for this call
created_at	String	Task creation time


{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq1",
  "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"],
  "prompt": "Santa Claus and the bear hug by the lakeside.",
  "duration": 5,
  "seed": random_number,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "bgm": "false",
  "movement_amplitude": "auto",
  "payload":"",
  "created_at": "2025-01-01T15:41:31.968916Z"
}