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.