WaveSpeedAI APIVidu Reference to Video Q1

Vidu Reference to Video Q1

Transform your reference images into dynamic videos with consistent subjects and environments. Our advanced Multi-Entity Consistency technology ensures characters, objects, and scenes maintain their visual identity throughout the video.

Features

Reference to Video Q1

Features

Multi-Entity Consistency

  • Maintains visual identity of characters and objects
  • Preserves style and appearance across frames
  • Supports multiple reference subjects

Flexible Input

  • Accepts 1-3 reference images
  • Supports various aspect ratios (16:9, 9:16, 1:1)
  • Adjustable movement amplitude

Requirements

Images

  • Number: 1-3 reference images
  • Format: PNG, JPEG, JPG, WebP
  • Size: Minimum 128x128 pixels
  • Aspect ratio: Less than 1:4 or 4:1
  • File size: Maximum 50MB per image

Prompt

  • Maximum length: 1500 characters
  • Should describe desired motion and scene

Best Practices

  1. Use clear, high-quality reference images
  2. Provide detailed prompts for better results
  3. Consider scene composition in reference images
  4. Test different movement amplitudes for optimal output

Effect Boundaries

  • Best results with clear, well-lit reference images
  • Movement amplitude affects transition smoothness
  • Complex scenes may require multiple reference images

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/reference-to-video-q1" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "images": [
        "https://d1q70pf5vjeyhc.cloudfront.net/media/images/1752044067562333610_05bBXmGY.PNG"
    ],
    "prompt": "A character takes two natural steps in front of the camera and then strikes some poses",
    "aspect_ratio": "16:9",
    "movement_amplitude": "auto",
    "seed": 0
}'

# 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
imagesarrayYeshttps://d1q70pf5vjeyhc.cloudfront.net/media/images/1752044067562333610_05bBXmGY.PNG-Reference images for video generation. Requirements: 1. Accept 1-3 images; 2. Images can be URLs or Base64 encoded; 3. Supported formats: PNG, JPEG, JPG, WebP; 4. Minimum size: 128x128 pixels; 5. Aspect ratio: less than 1:4 or 4:1; 6. Maximum size: 50MB per image.
promptstringYes-Text prompt: A textual description for video generation, with a maximum length of 1500 characters
aspect_ratiostringNo16:9-The aspect ratio of the output video. Defaults to 16:9, accepted: 16:9 9:16 1:1.
movement_amplitudestringNoauto-The movement amplitude of objects in the frame. Defaults to auto, accepted value: auto, small, medium, large.
seedintegerNo--1 ~ 2147483647The seed to use for generating the video. Random seed: Defaults to a random seed number; Manually set values will override the default random seed.

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 Query Parameters

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
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
© 2025 WaveSpeedAI. All rights reserved.