Vidu Image To Video Q1

Playground

Vidu Image-to-Video creates smooth transition videos from specified start and end images, producing seamless image-to-video outputs for presentations and storytelling. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Vidu Image-to-Video Q1

Vidu Image-to-Video Q1 is a high-quality image-to-video generation model that transforms static images into dynamic, cinematic videos. Simply provide an image and describe the motion you want — the model brings your photo to life with smooth, natural animation.

Why It Stands Out

Image-driven generation: Start from any image and animate it into a coherent video while preserving the original style.
Prompt-guided motion: Describe the action, camera movement, or atmosphere you want and watch your vision unfold.
Prompt Enhancer: Built-in AI-powered prompt optimization helps craft better descriptions for improved results.
Movement control: Adjust motion intensity with the movement_amplitude parameter for subtle or dramatic animations.
Reproducibility: Use the seed parameter to recreate exact results or explore variations.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of desired motion and style.
image	Yes	Source image (upload or public URL).
movement_amplitude	No	Motion intensity: auto, or specific levels (default: auto).
seed	No	Set for reproducibility; leave empty for random.

How to Use

Upload your source image — drag and drop a file or paste a public URL.
Write a prompt describing the motion, mood, and style you want. Use the Prompt Enhancer for AI-assisted optimization.
Set movement amplitude — choose auto or adjust for subtle/dramatic motion.
Set a seed (optional) for reproducible results.
Click Run and wait for your video to generate.
Preview and download the result.

Best Use Cases

Social Media Content — Turn photos into engaging video posts for TikTok, Reels, and Shorts.
Marketing & Advertising — Animate product images and hero shots without expensive video production.
Storytelling & Art — Bring illustrations, portraits, and artwork to life.
E-commerce — Create dynamic product showcases from static photography.
Personal Projects — Animate family photos, travel shots, or creative artwork.

Pricing

Output	Price
Per video	$0.40

Pro Tips for Best Quality

Use high-resolution, well-lit source images for optimal results.
Be specific in your prompt — describe camera movement, subject actions, and atmospheric details.
Use “auto” for movement_amplitude to let the model choose appropriate motion intensity.
For portraits, describe subtle movements like blinking, breathing, or hair movement for natural results.
Fix the seed when iterating to compare the effect of different prompts.

Notes

Ensure uploaded image URLs are publicly accessible.
Processing time varies based on current queue load.
Please ensure your prompts comply with content guidelines.

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/v3/vidu/image-to-video-q1" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "movement_amplitude": "auto"
}'

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

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes		-	The positive prompt for the generation.
image	string	Yes		-	The start image for generating the output.
movement_amplitude	string	No	auto	auto, small, medium, large	The movement amplitude of objects in the frame. Defaults to auto, accepted value: auto small medium large.
seed	integer	No	-	-1 ~ 2147483647	The random seed to use for the generation. -1 means a random seed will be used.

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 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, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	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.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 Image To Video Q2 Pro