Skip to main content
POST
/
v3
/
async
/
vidu-q2-pro-img2video
VIDU Q2 Pro Image-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "audio": true,
  "images": [
    {}
  ],
  "prompt": "<string>",
  "duration": 123,
  "off_peak": true,
  "voice_id": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Generate a new video based on reference images. Supports three resolutions: 540p, 720p, and 1080p.
This is an asynchronous API and will only return the task_id of the asynchronous task. You should use this task_id to request the Get Task Result API to retrieve the generated result.

​
Request Headers

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

​
Request Body

​
bgm
boolean
default:false
Whether to add background music
​
seed
integer
Random seed used to control the randomness of the generated result. The same seed will produce similar results.
​
audio
boolean
default:false
Whether to generate audio
​
images
array
required
List of input image URLsArray length: 1 - unlimited
​
prompt
string
required
Text prompt that describes the desired video content in detail
​
duration
integer
default:5
required
Video duration (seconds), supports 1-10 secondsAvailable values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
​
off_peak
boolean
default:false
Whether to enable off-peak task mode
​
voice_id
string
Voice ID, optional
​
watermark
boolean
default:false
Whether to add a watermark
​
resolution
string
default:"720p"
Output video resolution. The default value is 720p.Available values: 540p, 720p, 1080p
​
movement_amplitude
string
default:"auto"
Movement amplitude, controls the motion intensity of objects in the videoAvailable values: auto, small, medium, high

​
Response Information

​
task_id
string
required
Use task_id to request the Get Task Result API to retrieve the generated output.
​
provider_request_id
string
Provider request ID (optional)