Skip to main content
POST
/
v3
/
async
/
vidu-q3-pro-f2v
Vidu Q3 Pro First/Last Frame Video Generation
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-pro-f2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "audio": true,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "duration": 123,
  "off_peak": true,
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123
}
'
{
  "task_id": "<string>"
}
Vidu Q3 Pro First/Last Frame Video Generation can generate high-quality videos from first-frame and last-frame images, using text-guided motion interpolation and supporting resolutions up to 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 generation 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, used for reproducible results. Pass 0 for a random seed.
​
audio
boolean
default:true
Whether to generate audio while generating the video.
​
images
array
required
Two image URLs or Base64-encoded images. The first image is the first-frame image, and the second image is the last-frame image. Supports png, jpeg, jpg, and webp formats; each image must not exceed 50MB, must be at least 128x128 pixels, and the aspect ratio must be less than 1:4 or greater than 4:1. The resolutions of the first-frame and last-frame images must be similar (the first-frame/last-frame ratio must be between 0.8 and 1.25).Array length: 2 - 2
​
is_rec
boolean
Whether to enable recommendation mode.
​
prompt
string
Text describing the desired video motion effect between the first and last frames.Length limit: 0 - 1500
​
wm_url
string
Custom watermark image URL.
​
duration
integer
default:5
Duration of the generated video (seconds), range 1-16.Value range: [1, 16]
​
off_peak
boolean
default:false
Whether to use off-peak mode for lower cost.
​
watermark
boolean
Whether to add a watermark.
​
resolution
string
default:"720p"
Resolution of the generated video.Available values: 540p, 720p, 1080p
​
wm_position
integer
default:3
Watermark position: 1=top-left, 2=top-right, 3=bottom-right, 4=bottom-left.Value range: [1, 4]

​
Response Information

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