Skip to main content
POST
/
v3
/
async
/
vidu-q2-pro-multiframe
VIDU Q2 Pro Smart Multi-Frame
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-multiframe \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "wm_url": "<string>",
  "payload": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "start_image": "<string>",
  "wm_position": "<string>",
  "image_settings": [
    {
      "prompt": "<string>",
      "duration": 123,
      "key_image": "<string>"
    }
  ]
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Generate coherent videos from multiple keyframe images. Supports three resolutions: 540p, 720p, and 1080p.
This is an asynchronous API and only returns 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

​
wm_url
string
Watermark image URL. If watermarking is enabled but no custom watermark URL is provided, the default watermark is used. This parameter has no effect if no watermark is added.
​
payload
string
Pass-through parameter. It is not processed in any way and is only transmitted as data. Up to 1048576 characters.
​
meta_data
string
Metadata identifier, as a JSON-formatted string. Pass-through field.
​
watermark
boolean
default:false
Whether to add a watermark. true: add a watermark; false: do not add a watermark. Not added by default.
​
resolution
string
default:"720p"
Video resolution. Default is 720p.Allowed values: 540p, 720p, 1080p
​
start_image
string
required
First-frame image. Supports passing an image Base64 encoding or an image URL. Only 1 image is supported as input. Supports png, jpeg, jpg, and webp formats. The image aspect ratio must be within 1:4 to 4:1. Image size must not exceed 50 MB.
​
wm_position
string
default:"bottom_left"
Watermark position. Defaults to bottom left. This parameter has no effect if no watermark is added.Allowed values: top_left, top_right, bottom_right, bottom_left
​
image_settings
array
required
Keyframe configuration array. Each task requires at least 2 keyframes and supports up to 9 keyframes.Array length: 2 - 9

​
Response

​
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)