WaveSpeedAI APIViduVidu Text To Video Q2

Vidu Text To Video Q2

Vidu Text To Video Q2

Playground

Try it on WavespeedAI!

ViduQ2 Text to Video generates high-quality videos with exceptional visual quality and motion diversity

Features

Vidu Text-to-Video Q2 — Prompt-to-Clip (Preview)

Vidu Q2 turns your text prompts into short cinematic clips with coherent motion, balanced lighting, and reliable scene composition. It supports style presets, multiple aspect ratios, motion intensity control, and optional background music. Ideal for ads, social posts, explainers, and quick concept reels. Very suitable for animation creation.


✨ Highlights

  • Fast, stable motion with clear details and smooth camera paths.
  • Style presets + aspect ratios for platform-ready framing.
  • Motion amplitude to dial in subtle vs. energetic movement.
  • Optional BGM for instant, shareable clips.

🧩 Parameters

  • prompt* (text) — Describe subject, setting, lighting, camera, and action.
  • style (dropdown)general and animate .
  • resolution (dropdown)360p, 540p, 720p, 1080p.
  • duration (seconds slider) — up to 8s.
  • aspect_ratio (dropdown) - 4:3 or 3:4
  • movement_amplitude (dropdown)low, medium, high.
  • bgm (checkbox) — enable background music.

🚀 How to Use

  1. **Write the prompt — subject + camera + lighting + motion.
  2. Pick a style (general or animate).
  3. Choose resolution and aspect_ratio for your target platform.
  4. Set duration (seconds).
  5. Adjust movement_amplitude (low for subtle, high for dynamic).
  6. Toggle bgm if you want background music baked in.
  7. Click Run to generate and download your clip.

💰 Pricing

ResolutionDurationPricing
540p1s$0.10
540p2s$0.10
540p3s$0.10
540p4s$0.15
540p5s$0.15
540p6s$0.15
540p7s$0.15
540p8s$0.20
720p1s$0.15
720p2s$0.20
720p3s$0.20
720p4s$0.25
720p5s$0.25
720p6s$0.30
720p7s$0.30
720p8s$0.35
1080p1s$0.30
1080p2s$0.40
1080p3s$0.50
1080p4s$0.60
1080p5s$0.70
1080p6s$0.80
1080p7s$0.90
1080p8s$1.00

🧠 Prompting Tips

  • Start with subject + action + camera (“tracking shot of…”, “handheld close-up…”) and add lighting (“neon backlight”, “golden-hour sun”).
  • Use movement_amplitude instead of stuffing the prompt with motion words—cleaner results.
  • Keep style words minimal; let style preset and resolution do the heavy lifting.

Note

  • The style means the model has been specifically optimized for the particular scenario. It does not represent the final generated result. The final effect still needs to be specified in the prompt (general or anime).

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/text-to-video-q2" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "style": "general",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "4:3",
    "movement_amplitude": "auto",
    "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
promptstringYes-The positive prompt for the generation.
stylestringNogeneralgeneral, animeThe style of output video.
resolutionstringNo720p360p, 540p, 720p, 1080pThe resolution of the generated media.
durationnumberNo51 ~ 8The duration of the generated media in seconds.
aspect_ratiostringNo4:33:4, 4:3The aspect ratio of the generated media.
movement_amplitudestringNoautoauto, small, medium, largeThe movement amplitude of objects in the frame. Defaults to auto, accepted value: auto small medium large.
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.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

© 2025 WaveSpeedAI. All rights reserved.