Skip to main content
POST
/
v3
/
async
/
vidu-2.0-reference2video
Vidu 2.0 Reference-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-2.0-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}
'
{
  "task_id": "<string>"
}
Vidu 2.0 Reference-to-Video generates videos using reference images and text descriptions. It supports various subjects, such as characters and objects. By uploading multiple views of the subject, you can create videos that maintain visual consistency.
This is an asynchronous API and will only return the task_id of the asynchronous task. You should use that task_id to request the Get Task Result API to retrieve the video generation result.

​
Request Headers

​
Content-Type
string
required
Enum value: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API Key}}.

​
Request Body

​
images
string[]
required
The model will use the provided images as references to generate a video with a consistent subject.Image field requirements:
  • Accepts 1 to 3 images
  • Image resources can be provided via URL or Base64 encoding
  • Must use one of the following formats: PNG, JPEG, JPG, WebP
  • Image dimensions must be at least 128x128 pixels
  • Image aspect ratio must be less than 1:4 or 4:1
  • All images are limited to 50MB
  • The decoded base64 length must be less than 10MB and must include an appropriate content type string. For example:
data:image/png;base64,{base64_encode}
​
prompt
string
required
Text prompt for video generation, with a maximum length of 1500 characters.
​
duration
integer
Video duration in seconds. Default: 4 seconds. Options: 4.
​
seed
integer
Random seed for video generation.
  • Defaults to a random seed value
  • A manually set value will override the default random seed
​
aspect_ratio
string
Output video aspect ratio. Default: 16:9
Valid values: 16:9, 9:16, 1:1
​
resolution
string
The resolution parameter defaults to 360p. Options are 360p and 720p.
​
movement_amplitude
string
The movement amplitude of objects in the frame. Default: auto
Valid values: auto, small, medium, large
​
bgm
boolean
Whether to add background music to the generated video. Default: false
Valid values: true, falseWhen set to true, the system will automatically add suitable BGM. There is no duration limit for the BGM; the system will automatically adapt it.

​
Response

​
task_id
string
required
The task_id of the asynchronous task. You should use this task_id to request the Get Task Result API to obtain the generation result.