Skip to main content
POST
/
v3
/
async
/
vidu-q3-turbo-t2v
Vidu Q3 Turbo Text-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-turbo-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>"
}
Vidu Q3 Turbo Text-to-Video can generate high-quality videos with synchronized audio based on text descriptions, supporting up to 1080p resolution and durations from 1 to 16 seconds.
This is an asynchronous API and only returns 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 results. If omitted or set to 0, a random number is used.Value range: [0, 2147483647]
​
audio
boolean
default:true
Whether to use direct audio-video output capability (including dialogue and sound effects). false: output a silent video; true: output a video with sound. This parameter is supported only by Q3 series models.
​
prompt
string
required
Text description for video generation, up to 5000 characters.Length limit: 0 - 5000
​
wm_url
string
URL of the watermark image. If omitted, the default watermark is used (content generated by AI).
​
duration
integer
default:5
Video duration (seconds), range 1-16, default 5 seconds.Value range: [1, 16]
​
off_peak
boolean
default:false
Off-peak mode. true: generate the video during off-peak periods, consuming fewer credits, with the task completed within 48 hours; false: generate the video immediately.
​
watermark
boolean
default:false
Whether to add a watermark. true: add a watermark; false: do not add a watermark. No watermark is added by default.
​
resolution
string
default:"720p"
Output video resolution.Available values: 540p, 720p, 1080p
​
wm_position
integer
default:3
Watermark position: 1=top-left, 2=top-right, 3=bottom-right, 4=bottom-left. Default is 3 (bottom-right).Value range: [1, 4]
​
aspect_ratio
string
default:"16:9"
Output video aspect ratio.Available 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.