Browse ModelsViduVidu Q3 Pro Image To Video

Vidu Q3 Pro Image To Video

Vidu Q3 Pro Image To Video

Playground

Try it on WavespeedAI!

Vidu Q3 Pro Image-to-Video animates still images with high-quality motion via viduq3-pro (1–16s). Billing follows Vidu’s published Q3-pro per-second rates by resolution. Ready-to-use REST inference API on WaveSpeed.

Features

Vidu Q3 Pro Image-to-Video

Vidu Q3 Pro Image-to-Video transforms a reference image into a generated video clip with prompt-guided motion, controllable duration, resolution options, movement amplitude settings, and optional audio generation. It is designed for cinematic image animation, commercial visuals, social content, and other image-driven video generation workflows.


Why Choose This?

  • Image-guided video generation Start from a reference image and generate motion while preserving the core scene, subject, and visual identity.

  • Prompt-based motion control Use a text prompt to describe the motion, atmosphere, camera feel, and overall scene progression.

  • Flexible movement intensity Adjust movement_amplitude to control how subtle or dramatic the motion should be.

  • Optional audio generation Enable generated audio and optional background music for a more complete output.

  • Multiple resolution options Choose between 540p, 720p, and 1080p depending on your quality and cost needs.

  • Production-ready API Suitable for animated keyframes, marketing content, social video, concept visualization, and cinematic motion design workflows.


Parameters

ParameterRequiredDescription
imageYesReference image used as the starting visual input for video generation.
promptYesPositive prompt describing the desired motion, style, and scene behavior.
resolutionNoOutput resolution: 540p, 720p (default), or 1080p.
durationNoVideo duration in seconds. Range: 1–16. Default: 5.
movement_amplitudeNoMotion intensity: auto, small, medium, or large. Default: auto.
generate_audioNoWhether to generate audio. Default: true.
bgmNoWhether to include background music in the generated output. Default: true.
seedNoRandom seed for reproducibility. Use -1 for random generation.

How to Use

  1. Upload your image — provide the reference image you want to animate.
  2. Write your prompt — describe the motion, scene progression, style, and atmosphere you want.
  3. Choose resolution — use 540p, 720p, or 1080p based on your quality and budget needs.
  4. Set duration — choose the desired video length between 1 and 16 seconds.
  5. Adjust movement amplitude (optional) — use small, medium, or large, or leave it on auto.
  6. Configure audio options (optional) — enable or disable generated audio and background music.
  7. Set a seed (optional) — use -1 for random output, or a fixed seed for more reproducible generations.
  8. Submit — run the model and download the generated video.

Example Prompt

A cinematic travel shot of a lone figure standing on a desert road at sunset, warm natural light, subtle wind moving clothing and dust, slow camera pullback, realistic motion, stable composition


Pricing

Pricing is based on duration and resolution.

Resolution5s CostPer Second
540p$0.25$0.05
720p$0.625$0.125
1080p$0.75$0.15

Example Costs

Resolution1s5s10s16s
540p$0.05$0.25$0.50$0.80
720p$0.125$0.625$1.25$2.00
1080p$0.15$0.75$1.50$2.40

Billing Rules

  • Base price is $0.25 per 5 seconds at 540p
  • 720p costs 2.5× the base rate
  • 1080p costs the base rate
  • Pricing scales linearly with duration
  • movement_amplitude, generate_audio, bgm, and seed do not affect pricing

Best Use Cases

  • Image animation — Turn still images into short video clips with controlled motion.
  • Marketing creatives — Create animated hero visuals, ad content, and branded motion assets.
  • Social media video — Generate short-form animated clips for posts, reels, and promotional content.
  • Concept visualization — Bring keyframes, illustrations, or photo concepts to life with motion.
  • Atmospheric storytelling — Add subtle camera motion and scene dynamics to still images.
  • Audio-enabled video generation — Produce outputs with generated audio and background music for richer presentation.

Pro Tips

  • Use a clean, high-quality reference image for better stability and subject preservation.
  • Be specific in your prompt about motion, camera behavior, and atmosphere.
  • Start with 540p or 720p for testing, then switch to 1080p for higher-quality final outputs.
  • Use small or medium movement amplitude when you want more stable and natural animation.
  • Keep large movement amplitude for scenes that can tolerate stronger motion.
  • Reuse the same seed when you want more consistent variations.

Notes

  • Both image and prompt are required.
  • duration supports 1–16 seconds.
  • resolution defaults to 720p.
  • movement_amplitude defaults to auto.
  • generate_audio and bgm default to true.
  • seed uses -1 for random generation.
  • Pricing depends only on duration and resolution.

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/q3-pro/image-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "resolution": "720p",
    "duration": 5,
    "movement_amplitude": "auto",
    "generate_audio": true,
    "bgm": true
}'

# 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

ParameterTypeRequiredDefaultRangeDescription
imagestringYes-The URL of the image to generate an image from.
promptstringYes-The positive prompt for the generation.
resolutionstringNo720p540p, 720p, 1080pThe resolution of the generated media.
durationnumberNo51 ~ 16The duration of the generated media in seconds.
movement_amplitudestringNoautoauto, small, medium, largeThe movement amplitude of objects in the frame. Defaults to auto, accepted value: auto small medium large.
generate_audiobooleanNotrue-Whether to generate audio.
bgmbooleanNotrue-The background music for generating the output.
seedintegerNo--1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.