Browse ModelsViduVidu Q3 Reference To Video

Vidu Q3 Reference To Video

Vidu Q3 Reference To Video

Playground

Try it on WavespeedAI!

Vidu Q3 Reference-to-Video Mix generates multi-entity consistent videos from 1-4 reference images with text prompt guidance. Supports 360p to 1080p resolutions, up to 16 seconds duration, multiple aspect ratios, and optional audio generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Vidu Q3 Reference-to-Video

Vidu Q3 Reference-to-Video generates cinematic video guided by multiple reference images and a text prompt. Upload one or more reference images to establish character identity, style, or scene elements — the model produces a cohesive, motion-consistent video that blends all provided references into a new scene.


Why Choose This?

  • Multi-image reference generation Upload multiple reference images to combine characters, styles, or visual elements from different sources into a single coherent video.

  • Character-consistent output The model preserves the identity, appearance, and style of subjects from your reference images throughout the generated clip.

  • Optional audio generation Enable generate_audio to produce synchronized ambient sound and atmosphere alongside the video.

  • Flexible resolution options Generate at 480p, 720p, or 1080p to match your quality and budget requirements.

  • Reproducible results Use the seed parameter to lock in a specific output for exact reproduction.

  • Prompt Enhancer Built-in tool to automatically improve your scene descriptions for richer output.


Parameters

ParameterRequiredDescription
promptYesText description of the scene, action, and atmosphere.
imagesYesOne or more reference images. Click Add Item to include additional images.
aspect_ratioNoOutput aspect ratio. Default: 16:9.
resolutionNoOutput resolution: 480p, 720p (default), or 1080p.
durationNoClip length in seconds. Default: 5.
generate_audioNoWhether to generate synchronized audio for the video. Default: enabled.
seedNoRandom seed for reproducible results.

How to Use

  1. Write your prompt — describe the scene, characters, camera movement, and atmosphere. Use the Prompt Enhancer for better results.
  2. Upload your reference images — provide one or more images via URL or drag-and-drop. Click Add Item to add more.
  3. Select aspect ratio — choose the format that fits your target platform.
  4. Select resolution — 480p for lower cost, 720p or 1080p for higher quality.
  5. Set duration — choose your desired clip length in seconds.
  6. Enable audio (optional) — generate_audio is enabled by default; disable it if you only need video.
  7. Set seed (optional) — fix the seed to reproduce a specific result in future runs.
  8. Submit — generate, preview, and download your video.

Pricing

Duration480p720p / 1080p
5s$0.35$0.77
10s$0.70$1.54
15s$1.05$2.31

Billing Rules

  • 480p: $0.07 per second
  • 720p / 1080p: $0.154 per second (2.2× base rate)

Best Use Cases

  • Character-Driven Storytelling — Place consistent characters from reference images into entirely new scenes.
  • Social Media Content — Produce short-form video clips with consistent visual identity from reference photos.
  • Marketing & Brand Video — Generate new scenes featuring consistent brand characters or products from reference imagery.
  • Creative Concepting — Rapidly prototype multi-character or multi-element scenes for pitching and storyboarding.
  • Style-Consistent Series — Maintain a unified visual style across multiple video generations using the same reference set.

Pro Tips

  • Use clear, well-lit reference images with distinct subjects for the most accurate identity preservation.
  • The more reference images you provide, the richer the model’s understanding of your intended style and characters.
  • Disable generate_audio if you plan to add your own soundtrack in post-production.
  • Fix the seed once you find a result you like to iterate consistently across resolution and duration changes.
  • Use 480p to rapidly test your prompt and reference combination before committing to a higher-resolution render.

Notes

  • Both prompt and images are required fields; all other parameters are optional.
  • generate_audio is enabled by default — disable it explicitly if you do not need audio.
  • Ensure image URLs are publicly accessible if using links rather than direct uploads.
  • Please ensure your content complies with Vidu’s usage policies.

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/reference-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": 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
promptstringYes-The positive prompt for the generation.
imagesarrayYes[]1 ~ 4 itemsReference images for video generation. Requirements: 1. Accept 1-4 images; 2. Images can be URLs or Base64 encoded
aspect_ratiostringNo16:916:9, 9:16, 4:3, 3:4, 1:1The aspect ratio of the generated media.
resolutionstringNo720p360p, 540p, 720p, 1080pThe resolution of the generated media.
durationnumberNo51 ~ 16The duration of the generated media in seconds.
generate_audiobooleanNotrue-
seedintegerNo--1 ~ 2147483647The random seed to use for the generation.

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.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
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.