WaveSpeedAI APIPixversePixverse Pixverse V5 Transition

Pixverse Pixverse V5 Transition

Pixverse Pixverse V5 Transition

Playground

Try it on WavespeedAI!

Create smooth morph transitions between two static images into 5s or 8s videos at 360p, 540p, 720p, or 1080p. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

PixVerse v5 — Transition

PixVerse v5 Transition morphs one image into another with smooth, cinematic motion guided by a short prompt. Control aspect ratio, duration (5s / 8s), and resolution (360p–1080p) to fit storyboards, ads, and social posts.


✨ Highlights

  • Image-to-image transition with prompt-guided mood, lighting, and motion.
  • Multiple aspect ratios: 16:9, 1:1, 4:3, 3:4, 9:16.
  • Resolution choices: 360p, 540p, 720p, 1080p.

🧩 Parameters

  • prompt* (text) — Short description of vibe/motion (e.g., “Time-lapse build, dusk-to-night city lights, cinematic glow”).
  • image* (required) — Start frame (URL or upload).
  • end_image* (required) — End frame (URL or upload).
  • aspect_ratio16:9, 1:1, 4:3, 3:4, 9:16.
  • duration5 or 8 seconds.
  • resolution360p, 540p, 720p, 1080p.

🚀 How to Use

  1. Upload image (start) and end_image (target).
  2. Write a concise prompt describing transition mood, lighting, or timing.
  3. Pick aspect_ratio, duration, and resolution for your platform.
  4. (Optional) Select fast motion for snappier 5s transitions.
  5. Click Run to generate and download your clip.

💰 Pricing

Resolution5s ($/s)8s ($/s)
360p0.030.0375
540p0.030.0375
720p0.040.05
1080p0.080.10

🧠 Tips

  • Use start/end images with similar framing to reduce warping.
  • Keep prompts short—describe mood and timing rather than object changes.
  • For social platforms, match aspect_ratio to your target feed (16:9 landscape, 9:16 vertical).
  • Fast motion is best for punchy 5s reveals; use normal for smoother, more photographic transitions.

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/pixverse/pixverse-v5-transition" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "540p"
}'

# 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 model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
end_imagestringYes--The model generates video with the picture passed in as the last frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
aspect_ratiostringNo16:916:9, 1:1, 4:3, 3:4, 9:16The aspect ratio of the generated media.
durationintegerNo55, 8Video duration in seconds.
resolutionstringNo540p360p, 540p, 720p, 1080pVideo quality (360p/540p/720p/1080p).
negative_promptstringNo-The negative prompt for the generation.
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.