WaveSpeedAI APIViduVidu Start End To Video

Vidu Start End To Video

Vidu Start End To Video

Playground

Try it on WavespeedAI!

Vidu Start-End to Video generates smooth transition videos between specified start and end images.

Features

🌌 Vidu Start-End to Video

Vidu Start-End to Video generates smooth cinematic transitions between two specified images — turning a start and end frame into a 5-second, coherent video. Ideal for storyboarding, scene linking, and concept animation, it combines motion interpolation with prompt-guided realism for visually stunning results.


🌟 Why it stands out

  • 🎞️ Bi-Frame Guided Generation Creates natural motion between the start and end image while maintaining subject integrity.

  • ⚡ Temporal Coherence Ensures stable transitions with no flicker or frame artifacts.

  • 🧠 Context-Aware Motion Uses the text prompt to guide the transformation direction and emotional tone.

  • 🎬 Cinematic Realism Simulates real camera motion—zoom, pan, fade, or morph—matching your creative intent.


⚙️ Input Parameters

  • prompt — Describe the transition or narrative.

  • image — Upload the starting frame (JPEG/PNG).

  • last_image — Upload the ending frame (JPEG/PNG).

  • movement_amplitude — Controls the motion intensity within the transition:

    • auto – Automatically adjusts based on content.
    • small – Subtle, gentle motion for static or emotional scenes.
    • medium – Balanced camera and object movement.
    • large – Dynamic, cinematic transitions with stronger visual motion.

💰 Pricing

DurationCost per VideoResolution
5 seconds$0.20720p

🚀 How to Use

  1. 🖼️ Upload your start and end images.
  2. ✍️ Write a prompt describing the desired motion.
  3. 🎚️ Select movement_amplitude (auto, small, medium, or large).
  4. ▶️ Click Run ($0.20) to generate your transition.
  5. 💾 Preview and download your cinematic result.

💡 Pro Tips

  • Keep both input images aligned in composition and perspective for best transitions.
  • Use “medium” for natural storytelling and “large” for action or dramatic shifts.
  • Describe visual elements like lighting, direction, or camera movement for finer control.

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/start-end-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "movement_amplitude": "auto",
    "seed": -1
}'

# 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.
imagestringYes-The start image for generating the output.
last_imagestringYes--The end image for generating the output.
movement_amplitudestringNoautoauto, small, medium, largeThe movement amplitude of objects in the frame. Defaults to auto, accepted value: auto small medium large.
seedintegerNo-1-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.