VidU Reference to Video 2.0

Create videos that align with reference subjects—like characters, objects, and environments—using the world’s first Multi-Entity Consistency feature.

Features

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v2/vidu/reference-to-video-2.0" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "images": [
        "https://d2g64w682n9w0w.cloudfront.net/media/images/1745492230971199265_J3J5tO7p.jpg",
        "https://d2g64w682n9w0w.cloudfront.net/media/images/1745492247387641003_Z3jDAxur.jpg"
    ],
    "prompt": "the girl walks from the painting to the room, put the coffee cup on the table",
    "aspect_ratio": "16:9",
    "duration": 4,
    "movement_amplitude": "auto",
    "seed": 0
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v2/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
images	array	Yes	https://d2g64w682n9w0w.cloudfront.net/media/images/1745492230971199265_J3J5tO7p.jpghttps://d2g64w682n9w0w.cloudfront.net/media/images/1745492247387641003_Z3jDAxur.jpg	-	The images to use as input for the video generation.
prompt	string	Yes	the girl walks from the painting to the room, put the coffee cup on the table	-	The prompt to generate the video from.
aspect_ratio	string	No	16:9	-
duration	integer	No	4	-	The duration of the generated video in seconds.
movement_amplitude	string	No	auto	-	The movement amplitude for the video generation.
seed	integer	No	-	-1 ~ 9999999999	The seed to use for generating the video.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Query Parameters

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

VidU Image to Video 2.0 VidU Start End to Video 2.0