Skip to main content
POST
/
v3
/
async
/
vidu-2.0-img2video
Vidu 2.0 Image to Video
curl --request POST \
  --url https://api.novita.ai/v3/async/vidu-2.0-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}
'
{
  "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 2.0 Image to Video transforms static images into dynamic videos, incorporating creative storytelling and animations.
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

​
images
string[]
required
An image to be used as the start frame of the generated video.For fields that accept images:
  • Only accepts 1 image
  • Accepts public URL or Base64 format
  • Supported formats: png, jpeg, jpg, webp
  • The aspect ratio of the images must be less than 1:4 or 4:1
  • All images are limited to 50MB
  • The length of the base64 decode must be under 10MB, and it must include an appropriate content type string. For instance:
data:image/png;base64,{base64_encode}
​
prompt
string
Text prompt for video generation, with a maximum length of 1500 characters.
​
duration
integer
Video duration in seconds. Default is 4 seconds, with options available for 4 or 8 seconds.
​
seed
integer
Random seed for video generation.
  • Defaults to a random seed number
  • Manually set values will override the default random seed
​
resolution
string
Resolution based on duration:
  • 4s: default 360p, options: 360p, 720p, 1080p
  • 8s: default 720p, options: 720p
​
movement_amplitude
string
The movement amplitude of objects in the frame. Default: auto
Accepted values: auto, small, medium, large
​
bgm
boolean
Whether to add background music to the generated video. Default: false
Acceptable values: true, falseWhen true, the system will automatically add a suitable BGM. BGM has no time limit and the system automatically adapts.

​
Response

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