Skip to main content
POST
/
v3
/
async
/
vidu-q3-pro-t2v
Vidu Q3 Pro Text-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-pro-t2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "audio": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "duration": 123,
  "off_peak": true,
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>"
}
This is an asynchronous API and only returns the task_id of the asynchronous task.
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

​
seed
integer
Random seed for reproducible results. Use 0 for random.Value range: [0, 2147483647]
​
audio
boolean
default:true
Whether to use the audio-video direct output capability (including dialogue and sound effects). This parameter is supported only by Q3 models.
​
prompt
string
required
Text description for video generation, up to 2000 characters.Length limit: 0 - 2000
​
wm_url
string
Watermark image URL.
​
duration
integer
default:5
Video duration in seconds, range 1-16.Value range: [1, 16]
​
off_peak
boolean
default:false
Use off-peak mode. The task will be processed within 48 hours at a lower cost.
​
watermark
boolean
default:false
Whether to add a watermark.
​
resolution
string
default:"720p"
Output video quality.Allowed values: 540p, 720p, 1080p
​
wm_position
integer
Watermark position: 1=top-left, 2=top-right, 3=bottom-left, 4=bottom-right.Value range: [1, 4]
​
aspect_ratio
string
default:"16:9"
Output video aspect ratio.Allowed values: 16:9, 9:16, 4:3, 3:4, 1:1

​
Response

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