Skip to main content
POST
/
v3
/
async
/
vidu-q3-pro-i2v
Vidu Q3 Pro Image-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-pro-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "audio": "<string>",
  "style": "<string>",
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "duration": 123,
  "off_peak": true,
  "watermark": true,
  "resolution": "<string>",
  "wm_position": "<string>",
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>"
}
The Vidu Q3 Pro image-to-video tool converts static images into dynamic videos, generating natural motion and smoother scene dynamics while maintaining subject consistency.
This is an asynchronous API and will only return the asynchronous task’s task_id. 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

​
seed
integer
Random seed for reproducible generation; 0 or omitted means random generation.Value range: [0, 2147483647]
​
audio
string
Custom audio URL for the video’s background music; supports mp3, wav, m4a, and flac formats; maximum 20MB.
​
style
string
default:"general"
Output visual style; general is a realistic style, and anime is an anime style.Optional values: general, anime
​
images
array
required
Array of reference image URLs; supports .jpg, .jpeg, .png, .webp. Each image must be no larger than 50MB; the aspect ratio must be between 1:4 and 4:1. Currently, only 1 input image is supported.
​
is_rec
boolean
default:false
Enable audio-video matching; when set to true, the audio rhythm is synchronized with the video dynamics.
​
prompt
string
Motion description for video generation; describe scene motion, actions, and dynamic effects.Length limit: 0 - 1500
​
wm_url
string
Custom watermark image URL; supports png, jpeg, jpg, and webp formats; maximum 10MB.
​
duration
integer
default:5
Video duration (seconds)Value range: [1, 16]
​
off_peak
boolean
default:false
Use off-peak pricing; when set to true, the task queues for off-peak processing to reduce costs.
​
watermark
boolean
default:false
Enable a watermark on the output video.
​
resolution
string
default:"720p"
Output video resolutionOptional values: 540p, 720p, 1080p
​
wm_position
string
Watermark position on the videoOptional values: top-left, top-right, bottom-left, bottom-right
​
aspect_ratio
string
default:"16:9"
Output video aspect ratioOptional values: 16:9, 9:16, 4:3, 3:4, 1:1

​
Response

​
task_id
string
required
Use the task_id to request the Get Task Result API to retrieve the generated output.