Skip to main content
POST
https://api.novita.ai
/
v3
/
async
/
vidu-q2-text2video
VIDU Q2 Text to Video
curl --request POST \
  --url https://api.novita.ai/v3/async/vidu-q2-text2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "audio": true,
  "style": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "subjects": [
    {
      "id": "<string>",
      "images": [
        {}
      ],
      "voice_id": "<string>"
    }
  ],
  "watermark": true,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>"
}
VIDU Q2 Text to Video API, supports multiple resolution options. Generates video content based on text descriptions.
This is an asynchronous API; only the task_id will be returned. You should use the task_id to request the Task Result API to retrieve the video generation results.

​
Request Headers

​
Content-Type
string
required
Supports: application/json
​
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
bgm
boolean
default:false
Whether to add background music
​
seed
integer
Random seed, used to control the randomness of the generation result. The same seed will produce similar results.
​
audio
boolean
default:false
Whether to generate audio
​
style
string
Video style, e.g., cinematic, realistic, artistic, etc.
​
prompt
string
required
Text prompt, describing the desired video content in detailLength limit: 1 - unlimited
​
duration
integer
default:5
required
Video duration in seconds, supports 1-10 secondsOptional values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
​
subjects
array
default:"[]"
List of subjects, each containing id, images, and voice_id (can be empty for text-to-video)
​
watermark
boolean
default:false
Whether to add watermark
​
resolution
string
default:"720p"
Output video resolution. Default is 720p.Optional values: 540p, 720p, 1080p
​
aspect_ratio
string
Video aspect ratio, e.g., 16:9, 9:16, 1:1, etc.
​
movement_amplitude
string
Movement amplitude, controls the intensity of object movement in the videoOptional values: auto, small, medium, high

​
Response

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