Skip to main content
POST
/
v3
/
async
/
vidu-q2-reference2video
VIDU Q2 Reference Image to Video
curl --request POST \
  --url https://api.novita.ai/v3/async/vidu-q2-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "audio": true,
  "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 reference image to video API, supports multiple resolution options. Generates new video content based on reference image.
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 for controlling randomness. Same seed produces similar results.
​
audio
boolean
default:false
Whether to generate audio
​
prompt
string
required
Text prompt, can use @1, @2, etc. placeholders to reference subjects
​
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
required
List of subjects, each containing id, images, and voice_idArray length: 1 - unlimited
​
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, such as 16:9, 9:16, 1:1, etc.
​
movement_amplitude
string
Movement amplitude, controls the intensity of object movementOptional 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.