VIDU Q2 Pro Fast Image-to-Video
curl --request POST \
--url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"bgm": true,
"seed": 123,
"audio": true,
"images": [
"<string>"
],
"prompt": "<string>",
"duration": 123,
"off_peak": true,
"voice_id": "<string>",
"watermark": true,
"resolution": "<string>",
"movement_amplitude": "<string>"
}
'import requests
url = "https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video"
payload = {
"bgm": True,
"seed": 123,
"audio": True,
"images": ["<string>"],
"prompt": "<string>",
"duration": 123,
"off_peak": True,
"voice_id": "<string>",
"watermark": True,
"resolution": "<string>",
"movement_amplitude": "<string>"
}
headers = {
"Content-Type": "<content-type>",
"Authorization": "<authorization>"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': '<content-type>', Authorization: '<authorization>'},
body: JSON.stringify({
bgm: true,
seed: 123,
audio: true,
images: ['<string>'],
prompt: '<string>',
duration: 123,
off_peak: true,
voice_id: '<string>',
watermark: true,
resolution: '<string>',
movement_amplitude: '<string>'
})
};
fetch('https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bgm' => true,
'seed' => 123,
'audio' => true,
'images' => [
'<string>'
],
'prompt' => '<string>',
'duration' => 123,
'off_peak' => true,
'voice_id' => '<string>',
'watermark' => true,
'resolution' => '<string>',
'movement_amplitude' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video"
payload := strings.NewReader("{\n \"bgm\": true,\n \"seed\": 123,\n \"audio\": true,\n \"images\": [\n \"<string>\"\n ],\n \"prompt\": \"<string>\",\n \"duration\": 123,\n \"off_peak\": true,\n \"voice_id\": \"<string>\",\n \"watermark\": true,\n \"resolution\": \"<string>\",\n \"movement_amplitude\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video")
.header("Content-Type", "<content-type>")
.header("Authorization", "<authorization>")
.body("{\n \"bgm\": true,\n \"seed\": 123,\n \"audio\": true,\n \"images\": [\n \"<string>\"\n ],\n \"prompt\": \"<string>\",\n \"duration\": 123,\n \"off_peak\": true,\n \"voice_id\": \"<string>\",\n \"watermark\": true,\n \"resolution\": \"<string>\",\n \"movement_amplitude\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = '<authorization>'
request.body = "{\n \"bgm\": true,\n \"seed\": 123,\n \"audio\": true,\n \"images\": [\n \"<string>\"\n ],\n \"prompt\": \"<string>\",\n \"duration\": 123,\n \"off_peak\": true,\n \"voice_id\": \"<string>\",\n \"watermark\": true,\n \"resolution\": \"<string>\",\n \"movement_amplitude\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "<string>",
"provider_request_id": "<string>"
}Video
VIDU Q2 Pro Fast Image-to-Video
POST
/
v3
/
async
/
vidu-q2-pro-fast-img2video
VIDU Q2 Pro Fast Image-to-Video
curl --request POST \
--url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"bgm": true,
"seed": 123,
"audio": true,
"images": [
"<string>"
],
"prompt": "<string>",
"duration": 123,
"off_peak": true,
"voice_id": "<string>",
"watermark": true,
"resolution": "<string>",
"movement_amplitude": "<string>"
}
'import requests
url = "https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video"
payload = {
"bgm": True,
"seed": 123,
"audio": True,
"images": ["<string>"],
"prompt": "<string>",
"duration": 123,
"off_peak": True,
"voice_id": "<string>",
"watermark": True,
"resolution": "<string>",
"movement_amplitude": "<string>"
}
headers = {
"Content-Type": "<content-type>",
"Authorization": "<authorization>"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': '<content-type>', Authorization: '<authorization>'},
body: JSON.stringify({
bgm: true,
seed: 123,
audio: true,
images: ['<string>'],
prompt: '<string>',
duration: 123,
off_peak: true,
voice_id: '<string>',
watermark: true,
resolution: '<string>',
movement_amplitude: '<string>'
})
};
fetch('https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bgm' => true,
'seed' => 123,
'audio' => true,
'images' => [
'<string>'
],
'prompt' => '<string>',
'duration' => 123,
'off_peak' => true,
'voice_id' => '<string>',
'watermark' => true,
'resolution' => '<string>',
'movement_amplitude' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video"
payload := strings.NewReader("{\n \"bgm\": true,\n \"seed\": 123,\n \"audio\": true,\n \"images\": [\n \"<string>\"\n ],\n \"prompt\": \"<string>\",\n \"duration\": 123,\n \"off_peak\": true,\n \"voice_id\": \"<string>\",\n \"watermark\": true,\n \"resolution\": \"<string>\",\n \"movement_amplitude\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video")
.header("Content-Type", "<content-type>")
.header("Authorization", "<authorization>")
.body("{\n \"bgm\": true,\n \"seed\": 123,\n \"audio\": true,\n \"images\": [\n \"<string>\"\n ],\n \"prompt\": \"<string>\",\n \"duration\": 123,\n \"off_peak\": true,\n \"voice_id\": \"<string>\",\n \"watermark\": true,\n \"resolution\": \"<string>\",\n \"movement_amplitude\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-img2video")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = '<authorization>'
request.body = "{\n \"bgm\": true,\n \"seed\": 123,\n \"audio\": true,\n \"images\": [\n \"<string>\"\n ],\n \"prompt\": \"<string>\",\n \"duration\": 123,\n \"off_peak\": true,\n \"voice_id\": \"<string>\",\n \"watermark\": true,\n \"resolution\": \"<string>\",\n \"movement_amplitude\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "<string>",
"provider_request_id": "<string>"
}Generate a new video based on reference images (fast mode). Supports both 720p and 1080p resolutions. Fast mode can significantly reduce generation time and is suitable for scenarios with high speed requirements.
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
string
required
Enum value:
application/jsonstring
required
Bearer authentication format: Bearer {{API Key}}.
Request Body
boolean
default:false
Whether to add background music
integer
Random seed, used to control the randomness of the generated result. The same seed will produce similar results.
boolean
default:false
Whether to generate audio
string[]
required
List of input image URLsArray length: 1 - unlimited
string
required
Text prompt that describes the desired video content in detail
integer
default:5
required
Video duration (seconds), supports 1-10 secondsAllowed values:
1, 2, 3, 4, 5, 6, 7, 8, 9, 10boolean
default:false
Whether to enable off-peak task mode
string
Voice ID, optional
boolean
default:false
Whether to add a watermark
string
default:"720p"
The resolution of the output video. Supports 720p and 1080p. The default value is 720p.Allowed values:
720p, 1080pstring
default:"auto"
Movement amplitude, controls the intensity of object movement in the videoAllowed values:
auto, small, medium, highResponse Information
string
required
Use task_id to request the Get Task Result API to retrieve the generated output.
string
Provider request ID (optional)