Skip to main content
POST
/
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>"
}

Documentation Index

Fetch the complete documentation index at: https://novita.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.